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How to Use this Manual 



INTRODUCTION 



ORGANIZATION 



This manual describes how to use the Altos implementa- 
tion of the XENIX operating system and the Altos menu 
system called the Business Shell. The Business Shell 
allows you to easily use basic system functions such as 
creating directories and backing up and restoring files. 

This manual is for a person who wants to create, copy, 
and print files. This manual is also for the person 
who installs and maintains the system; we call 
that person the system administrator. The system 
administrator performs administrative functions 
such as installing the software, and checking disk 
space and the file system. 

Chapters 1 and 4 are for the system administrator. 
They describe XENIX installation procedures and system 
administration utilities, respectively. If you are not 
the system administrator, you can skip to Chapter 2, 
which te lis you how to log in to the system. 

This manual does not describe how to set up your 
system (see the particular setting up manual or 
operator's guide for this information) or run the 
application software that you have purchased with 
your system. 



This manual is organized as follows: 

Chapter 1 tells you how to initially install and set up 
the XENIX operating system, reconfigure ports for your 
terminals and printers, and set up login user accounts. 

Chapter 2 explains how to access the system (log in), 
set passwords, and exit from the system when you finish 
(log off). 

Chapter 3 describes XENIX functions that you use on a 
regular basis. These include accessing the system from 
the Business Shell, working with files, and running 
programs. 
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Chapter 4 describes the role of the system administra- 
tor. 

Chapter 5 explains how to use the XENIX line editor 
called "fid." 

Appendix A describes the utilities furnished with the 
XENIX Run-Time operating system. 

Appendix B explains control character sequences. 

Appendix C describes the file transfer programs used to 
transfer ASCII text or binary data files between Altos 
systems. 

Appendix D details how to upgrade your XENIX operating 
system. 

Appendix E describes how to connect modems. 



DOCUMENTATION 
CONVENTIONS 



This section describes documentation conventions used 
in this manual. 

Because this manual is for all Altos systems that 
use the XENIX run- time operating system, your 
screens may differ from the screens shown in this 
manual. 

All information you enter is shown in bold face. 
Examples are 

Select k. System Administration, and then c. Port 
Configuration. 

Enter y <CR> 

Any designation inside angle brackets (< >) refers to a 
key, which, when pressed, does not produce a character 
on the screen. For example, the symbol <CR> means 
Carriage Return and refers to the Return key. When you 
see the symbol <CR> in bold face, you should press the 
Return key. For example. 

Press <CK> Press <Space Bar> 

When you see the symbol <Control-D>, you should press 
and hold down the Control key while you press the D key 
(either a lowercase d or an uppercase D). For example, 

<Control-D> 
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When entering commands, do not enter the space after 
the prompt, this space is provided by the XENIX opera- 
ting system. For the example, 

$ who <CR> 

you would type "who" and then press the Return key. 

Variable information (a value that can change) is shown 
using three lower-case letters: n, a, and x. They 
mean, respectively, any number, any letter, and any 
character, either letter or number. For example, 

#1 of n Version n.na Filename xxxxxx 



ADDITIONAL 

REFERENCE 

MATERIAL 

XENIX 

Reference 

Card 

Altos Setting 
Dp or 

Operator's 
Guide 

Altos 

Diagnostic 

Manual 

A User Guide 
to the UNIX 
System 



Altos WorkNet 
User' s Guide 

Altos XENIX 
Development 
System Set 



This section lists additional Altos and XENIX publica- 
tions. 



This card briefly explains how to log in and log out, 
lists basic XENIX commands, and lists the Business 
Shell menu selections. 

This manual describes how to connect workstation compo- 
nents, connect peripherals, turn on power, and how to 
load the diagnostic programs. 



This manual describes diagnostic programs for Altos 
computer systems. 



This book, by Thomas and Yates, is provided with the 
XENIX operating system. The book explains UNIX con- 
cepts and provides tutorials for getting started with 
UNIX and for implementing the most common commands. 

This document provides information on how to install 
the optional WorkNet network package and how to use it. 

This set, provided only with the XENIX development 
system, includes reference and tutorial material 
for programs available in the Altos XENIX development 
system. 
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Preface 



INTRODOCTION 



ORGANIZATION 



This manual describes how to use the Altos implementa- 
tion of the XENIX operating system and the Altos menu 
system called the Business Shell. The Business Shell 
allows you to easily use basic system functions such as 
creating directories and backing up and restoring 
files. 

This manual is for a person who wants to create, copy, 
and print files. This manual is also for the person 
who installs and maintains the system; we call that 
person the system administrator. He performs adminis- 
trative functions such as installing the software, and 
checking disk space and the file system. 

Chapters 1 and 4 are for the system administrator. 
They describe XENIX installation procedures, and system 
administration utilities, respectively. If you are not 
the system administrator, you can skip to Chapter 2, 
which tells you how to log in to the system. 

This manual does not describe how to set up your system 
(see the Altos 586 and 986 Computer System Operator's 
fiilidfi) , or run the application software that you have 
purchased with your system. 



This manual is organized as follows: 

Chapter 1 tells you how to initially install and set up 
the XENIX operating system, reconfigure ports for your 
terminals and printers, and set up login user accounts. 

Chapter 2 explains how to access the system (log in), 
set passwords, and exit from the system when you finish 
(log off). 

Chapter 3 describes XENIX functions that you use on a 
regular basis. These include accessing the system from 
the Business Shell, working with files, and running 
programs . 
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Chapter 4 describes the role of the system administra- 
tor. 

Chapter 5 explains how to use the XENIX line editor 
called 

Appendix A describes the utilities furnished with the 
XENIX Run-Time operating system. 

Appendix B explains control character sequences. 

Appendix C describes the file transfer programs used to 
transfer ASCII text or binary data files between Altos 
systems. 

Appendix D details how to upgrade your XENIX operating 
system. 

Appendix E describes how to connect modems. 



DOCDNENTATION 
CONVENTIONS 



This section describes documentation conventions used 
in this manual. 

All information you enter is shown in bold £ace. Exam- 
ples are 

Select k, System Administration, and then c. Port 
Configuration. 



Enter y <CR> 



Any designation inside angle brackets (< >) refers to a 
key, which, when pressed, does not produce a character 
on the screen. For example, the symbol <CR> means 
Carriage Return and refers to the Return key. When you 
see the symbol <CR> in bold face, you should press the 
Return key. For example, 

Press <CR> Press <Space Bar> 

When you see the symbol <Control-D>, you should press 
and hold down the Control key while you press the D key 
(either a lowercase d or an uppercase D). For example. 



<Control-D> 



When entering commands, do not enter the space after 
the prompt, this space is provided by the XENIX opera- 
ting system. For the example, 

$ who <CR> 

you would type "who" and then press the Return key. 
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Variable information (a value that can change) is shown 
using three lower-case letters: n, a, and x. They 
mean, respectively, any number, any letter, and any 
character, either letter or number. For example, 

#1 of n Version n.na Filename xxxxxx 
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This section lists additional Altos and XENIX publica- 
tions. 



This card briefly explains how to log in and log out, 
lists basic XENIX commands, and lists the Business 
Shell menu selections. 

This manual describes how to connect workstation compo- 
nents, connect peripherals, turn on power, and how to 
load the diagnostics programs. 



This manual describes diagnostic programs for Altos 
computer systems. 



This document provides information on how to install 
the optional WorkNet network package and how to use it. 

This set, provided only with the XENIX development 
system, includes reference and tutorial material for 
programs available in the Altos XENIX development system. 
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After you connect the components of your Altos computer 
system and turn on the power, you need to install the 
operating system programs and utilities. 

This chapter describes how to install the XENIX opera- 
ting system for the first time. This chapter also 
describes how to set up the ports, create and change 
user accounts, and set up the system for other users, 

CAUTION 

The installation procedures described in this 
chapter erase all information on the hard 
disk. If you are upgrading your existing 
XENIX operating systemr use the procedures 
described in Appendix D. 



Before you install XENIX, 

1, Connect the terminal you use for the installation 
procedures to the port marked port 1 or CRT on the 
back of your Altos computer system (see the Opera- 
tor's Guide or Setting Up Manual for instruc- 
tions) . 

2, Optionally, run the system diagnostic tests. Be- 
cause the Altos system is tested before shipping, 
this step is optional. However, you can run the 
diagnostic tests to detect problems that could 
occur as a result of shipment (such as loosening 
of components and connections). The tests take 
from one to two hours. See the Altos Diagnostic 
Manual for instructions, 

3, Use the diagnostics copy utility to make copies of 
all XENIX installation diskettes, and hand copy 
the label information, (The Diagnostics diskette 
has a copy utility that you can use. See the 
Altos Diagnostic Manual for information.) Store 
the originals in a safe place, 

4, Assemble the copied set of XENIX installation 
diskettes. Installation diskettes are labeled as 
follows: 

XENIX Root File System 



XENIX Utilities 



NOTE 



If you have the optional XENIX Development 
System, you will also receive additional 
diskettes, such as XENIX Development System 
Utilities and the C compiler. 

If you are not familiar with handling floppy diskettes, 
see the Altos Operator's Guide or Setting Up Manual for 
instructions. 



INSTALLATION Installing the XENIX Operating System (for the first 

SUMMARY time on the hard disk) is summarized here. 

Detailed installation procedures follow. 

1. Start up (boot) the system from your copy of the 
XENIX Root File System diskette. 

2. Load the utilities from the Utilities diskette. 

3. Optionally, reconfigure (set up) the ports. 

4. Create or change user login accounts, 

5. Optionally, install the XENIX Development System, 
WorkNet communication network package, or any 
application software packages. (Refer to particu- 
lar Altos or vendor manuals for installation in- 
structions. ) 

6. Set up the system to display "login" on the other 
terminals so other users can use the system. 



INSTALLING Allow one-half to one hour to install the XENIX opera- 

XBNIX ting system for the first time. If you stop the in- 

stallation before it is completed, the next time you 
work with the system a message indicates the system was 
not shut down properly. In this event, refer to Re- 
covering from Interrupted Installation at the end of 
this chapter. 

If you encounter problems or error messages not de- 
scribed in this manual (either during or after software 
installation), run the system diagnostic tests. See 
the Altos Diagnostic Manual for instructions. 

During installation, you can correct typing errors 
easily. Correct a single character by pressing the 
Backspace key. Erase a line with the Delete or Rubout 
key. 
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Note that the screen on the Altos terminal automati- 
cally turns off (blanks) if there is no input from the 
keyboard or the computer for 15 minutes. You can 
restore the screen display by pressing any key on the 
keyboard, 

1. Turn on the power switch, or with the power on, 

turn it off, then back on. You will see a monitor 
sign-on message; however, your screen may be dif- 
ferent from the screen below. 

Prepare to press any key when you are prompted. 



Monitor Version n. 



Press any key to interrupt boot 



If you do not get the monitor sign-on message, 
check that your console is properly set up and 
attached to the computer system. (Refer to Con- 
necting Additional Terminals and Printers in the 
Altos Operator's Guide or Setting Up Manual.) 

If you press a key in time, you will see a menu 
(Step 2 shows the first two items of the menu) . 
If not, press the RESET button, and press any key 
when prompted, 

2. When you see the following display, or one similar 
to it, remove the silver write-protect tab from 
your copy of the "XENIX Root File System" diskette 
and insert it into the disk drive. 

Enter 2 to boot from the floppy diskette. 



Enter [1] to boot from Hard Disk 

[2] to boot from Floppy Disk 

Enter option: 2 

Booting from floppy disk . . . 

After a delay of about 45 seconds, the screen 
displays messages about your version of XENIX and 
the size of available memory (in kbytes). 

3. The screen then displays the Welcome to XENIX 
menu. 
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WELCOME TO XENIX 
Version n.na 




Options : 

a. Install XENIX for the first time on your computer 

b. Upgrade your computer system to XENIX version n.na 

c. Restore data to the hard disk from cartridge tape 

d. Shut down the system 

e. Exit to the XENIX shell 



Enter option b, c, d, or e) and press RETDRN; 



The 486 does not have the restore data from tape 
option, and the screen is adjusted accordingly. 



The screen displays 



/ Installing XENIX will overwrite ALL data on 
/ the hard disk. 

/ Do you want to continue? (y/n) 

Because this is the first time you are installing 
the XENIX operating system, your hard disk does 
not have any data on it. 

Enter y <CB> 

The screen displays 

Do you want a standard swap size and/or 
number of files? (y/n) 





Enter a <CR> 



NOTE 



(Normally you will want to answer "yes" to 
this question.) 



This question refers to development systems that 
run very large application programs on the com- 
puter and need a large swap area. Most of the 
time you want the standard swap size. 



Enter y <CR> 

If you answer "n' 
screen displays 



to the above question, the 




How many 512-byte blocks do you want in the 
swap area? (Default = nnnn) 

How many files (i.e., i-nodes) do you want on 
the hard disk? (Default = nnnn) 



Enter a number and press <CR> in response to each 
of the above questions, 

6, During the next phase of installation, the com- 
puter checks the hard disk, makes the file system 
on the hard disk, and then checks the file system. 

The screen displays messages about what the com- 
puter is doing. These messages indicate that this 
phase is going well. 

The system may find a disk sector that should not 
be used. The system flags that sector so that it 
is not used in the future, and displays informa- 
tion about that sector. 

When the computer checks the file system, the 
screen displays 



/dev/hd0b 
** Phase 1 
** Phase 
** Phase 
** Phase 
** Phase 



Check Blocks and Sizes 
Check Pathnames 
Check Connectivity 
Check Reference Counts 
Check Free List 



nn files nnn blocks nnnnn free 

The file system on the hard disk is correct. 

Copying the system files to the hard disk... 

Creating the special system files on the 
hard disk... 
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If the file system on the hard disk is incorrect, 
the system will tell you. You should turn your 
system off, then back on, and try the installation 
procedure again. If this does not correct the 
problem, contact your dealer. 

If the file system is correct, the screen dis- 
plays the following messages. 



/ ** Normal System Shutdown ** 

After the system shuts down, it automatically 
passes power-up test and displays messages about 
the system configuration. 

The screen then displays 

I [ PRESS ANY KEY TO INTERRUPT AUTO-BOOT 

Don't press a key, because you want the system to 
automatically boot from the hard disk. If you do 
press a key, enter 1 <CR> to boot from the hard 
disk. 

After booting from the hard disk, screen displays 

Remove the "XENIX Root File System" diskette 
and store it in a safe place. 

Please insert the diskette labeled "XENIX 
Utilities" and press RETURN. 

So far, so good. The XENIX Root File System is 
installed on the hard disk. 

7. Remove the XENIX Root File diskette and store it. 

If you do not see the XENIX message after shut- 
down, your hard disk has not been initialized 
correctly. Try repeating the installation process 
from the beginning. If this does not work, con- 
sult your Altos Dealer. 

8, Insert your copy of the diskette labeled "XENIX 
Utilities" (with a write-protect tab) and press 
<CR>. 

As Utilities are copied from diskette to hard 
disk, you will see messages of the form: 

X filename, nnnnn bytes, nn tape blocks 
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INSTALLING 
A SECOND 
HARD DISK 



You will also see messages saying that a file has 
been linked to another file. These messages are 
for information only. 

CAUTION 

Do not remove the diskette until the system 
tells you to remove it and the red indicator 
light on the disk drive goes off. 

After the last file has been copied to hard disk 
from the diskette, the display of file names 
stops. You will see the following message: 




Remove the "XENIX Utilities" diskette and 
store it in a safe place. 

9. Remove the XENIX Utility diskette and store it. 

10, Then the screen displays 

I Configuring the other system files., • 
The system begins this phase of installation by asking 



Do you want to instal 1 a second hard disk on your 
system? (y/n) 



If you do not have a second hard disk, enter n <CR> and 
skip this step. 

If you have a second hard disk connected to your com- 
puter system, enter 



y <CR> 



NOTE 



Press the Delete or Rubout key at any time to 
abort installation of the second hard disk. 

The screen displays 

Do you want a standard number of files on the 
second hard disk? (y/n) 

(Normally, you will want to answer "yes" to this 
question, ) 
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This question refers to development systems that run 
very large application programs and need a different 
number of files. Most of the time you want the stan- 
dard number of files. 

Enter y <CR> 

If you answer "n" to the above question, the screen 
displays 



/How many 512-byte blocks do you want in the 
/ swap area? (Default = nnnn) 

/ How many files (i.e., i-nodes) do you want on 
I the second hard disk? (Default = nnnn) 

Enter a number and press <CR> in response to each 
of the above questions. 

XENIX then sets up the file system on the second hard 
disk, and periodically displays messages about what it 
is doing. 

When the system finishes installing the second hard 
disk, the screen displays 



The file system on the second hard disk is 
correct. 



See "Recovering from Interrupted Installation" later in 
this chapter if the file system check does not occur as 
described. 



SETTIHG OP 
THE PORTS 
AHD OSER 
ACGODNTS 



During the next phase of installation, the system will 
ask if you want to do the following tasks: 

1. Change the descriptions of the terminal (s) and printer (j 
so the system will recognize them, 

2, Create accounts for yourself and current users. 

In the future, you will only be able to do these tasks 
from the Business Shell as the system administrator or 
"super user"; we'll explain more about the super user 
in Chapter 4. 



1-9 



Configuring 
the Ports 



The screen displays 



Do you want to change the description of the 
terminal (s) and printer (s)? (y/n) 



The ports on your Altos system are already set up 
for Altos terminals and a printer. Tables 1-1 and 
1-2 show the port settings for the 586/986 and 
486, respectively. 



Table 1-1. 586/986 Port Configuration 



Hardware Software Device Terminal Printer Baud Parity Word Modem? 



Name 


Name 


Type 


Type 


Number Rate 


Port 


1 


console 


terminal 


altos2 


9600 


Port 


2 


tty2 


terminal 


altos2 


9600 


Port 


3 


tty3 


terminal 


altos2 


9600 


Port 


4 


tty4 


terminal 


altos2 


9600 


Port 


5 


ttyS 


terminal 


altos2 


9600 


Port 


6 


tty6 


printer 




default 9600 


Port 


7 


tty7 


terminal 


altos2 


9600 


Port 


8 


ttyS 


terminal 




9600 


Port 


9 


tty9 


terminal 




9600 


Port 


10 


ttyl0 


terminal 




9600 



NOTE 

The 586 has 6 ports (1-6) and the 986 has 10 ports 
(1-10). 

Table 1-2. 486 Port Configuration 



Hardware 


Software 


Device 


Terminal 


Printer 


Baud 


Name 


Name 


Type 


Type 


Number 


Rate 


Port 1 


console 


terminal 


altos2 




9600 


Port 2 


tty2 


terminal 


altos2 




9600 


Port 3 


tty3 


terminal 


altQ82 




9600 


Port 4 


tty4 


terminal 


alt082 




9600 


Port 5 


ttyS 


printer 




default 


9600 



Len 



none 8 bits 
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V7hen you first install XENIX, you may need to reconfi- 
gure a port to tell the system what kind of terminal 
and/or printer is attached to the port. After the 
initial installation, use the Port Configuration pro- 
gram described in Chapter 4 to make future changes. 

If you need to change a port's setting, enter 

y <CR> 

The Port Configuration program display appears. See 
Chapter 4, Configuring the Ports, for instructions. 
Ignore the first two steps, which tell you how to 
access this program from the Business Shell. 

When you are finished with port configuration, return 
to the next section. 

If you do not need to change port settings, enter 
n <CR> 

and continue with the next section. 



Creating and 
Changing User 
Accounts 



Next, the screen displays 



/ Do you want to add more users and/or change 
/ existing user accounts? (y/n) 

You should create a user account login name for each 
person using the system when you first install XENIX, 
In the future, when you want to add or change user 
accounts, you can access this program from the Business 
Shell. 

Enter y <CR> 

The User Administration screen appears (see Figure 4-2) 

See Chapter 4, User Administration for instructions. 
Ignore the first three steps, which tell you how to 
access this program from the Business Shell. When you 
finish, return to the next paragraph to continue in- 
stallation. 

After you set up user accounts using the User Adminis- 
tration program, the installation proceeds and your 
screen displays the following: 
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Checking the file system on the hard disk... 



/dev/hd0b 

** Phase 1 - Check Blocks and Sizes 

** Phase 2 - Check Pathnames 

** Phase 3 - Check Connectivity 

** Phase 4 - Check Reference Counts 

** Phase 5 - Check Free List 

nn files nnn blocks nnn free 

XENIX Version n.nn is correctly installed on your 
computer 



If XENIX is not correctly installed, the system will 
tell you. You should turn your system off, then back 
on, and try the installation procedure again. If this 
does not correct the problem, contact your dealer. 

Next, the XENIX Options menu appears on the screen. 



USING 
THE XENIX 
OPTIONS MEND 



You can install additional software (such as the XENIX 
Development System or Worknet), set up the system so other 
users can log in, or shut down the system by using the 
XENIX options menu. 



Select one of the following options: 

a. Display the 'login' proapt on all teninals in the systea 

b. Continue with only one usee and install other software packages 

c. Shut down the systea 

Bnter option (a, bi or c) and press RETORN: 
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Installing 

Other 

Software 



Displaying 
■login:" on 
Other 
Terminals 



If you purchased the XENIX Development System, WorkNet 
communication package, or other appliction software, 
enter 

b <CR> 

and install them now. Refer to the appropriate manual 
for instructions. 

To display the "login" prompt on other terminals in the 
system (so other users can log in and use the system), 
enter 

a <CR> 

Then the screen displays the date and time. For 
example. 




I think it's Thu Sep 27 18:38:10 1984 
Enter date (yymmdd) or press RETURN if ok: 
Enter time (hhmm) or press RETURN if ok: 

To change the date and time, use the following format: 

yy = current year 

mm = current month 

dd = current day of month 

hh = hour (24-hour clock) 

mm = minutes 

For example, enter May 1, 1984 as 

840501 <CR> 
and enter 4:30 pm as 

1630 <CR> 

The screen displays the date and time as you set them, 
and the "login" prompt then appears. 



Altosnnn login: 
Now the system is set up for other users. 



Shotting 
Down the 

System 



If you want to turn the power off, first you should 
shut down the system; enter 

c <CR> 
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Returning to 
the Options 
Menu 



To return to the Options menu after you are finished 
with an option, if needed, log in as root, and enter 



options <CR> 



In the future, if you need to access the Options menu 
you must be logged in as the super user. From the 
System Administration menu of the Business Shell, type 
p. Go to System Maintenance Mode. At the XENIX prompt 
(#), enter 

options <CR> 



RECOVERING 
FROM 

INTERRUPTED 
INSTALLATION 



If installation is interrupted, you may receive the 
following message after you press the RESET button. 



/ The system was not shut down properly. 

/ The root file system will be cleaned, 

/ (Type "no" only if you want to avoid cleaning,) 

This process begins automatically after about 5 sec- 
onds, XENIX validates the consistency of the disk file 
system, which may have been damaged, and automatically 
repairs it. If there is no damage, you will see the 
following: 



/dev/root 
** Phase 1 - Check 
** Phase 2 - Check 
** Phase 3 - Check 
** Phase 4 - Check 
** Phase 5 - Check 



Blocks and Sizes 
Pathnames 
Connectivity 
Reference Counts 
Free List 



nn files nnn blocks nnnnn free 



If the file system was damaged, XENIX repairs it auto- 
matically and displays a log of the corrections that 
have been made. 

After the "** Rebooting **" message appears, the system 
may ask you to insert the Utilities diskette and press 
the Return key. 

If nothing appears on the screen after the message 
"Booting from Hard Disk," the installation procedure 
has failed. Start the installation procedure again by 
booting from the diskette labeled "XENIX Root File 
System. " 
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After you connect the components of your Altos computer 
system and turn on the power, you need to install the 
operating system programs and utilities. 

This chapter describes how to install the XENIX opera- 
ting system for the first time. This chapter also 
describes how to set up the ports, create and change 
user accounts, and set up the system for other users. 

CAUTION 

The installation procedures described in this 
chapter erase all information on the hard 
disk. If you are upgrading your existing 
XENIX operating system, use the procedures 
described in Appendix D, 



HOff TO START 



Before you install XENIX, 

1. Connect the terminal you use for the installation 
procedures to port 1 on the back of your Altos 
586/986 system (see the Altos 586 and 986 Computer 
Systems Operator's Guide for instructions). 

2. Optionally, run the system diagnostic tests. Be- 
cause the Altos system is tested before shipping, 
this step is optional. However, you can run the 
diagnostic tests to detect problems that could 
occur as a result of shipment (such as loosening 
of components and connections). The tests take 
from one to two hours. See the Altos 586 Computer 
System DiagnQstic Manual for instructions. 

3. Use the diagnostics copy utility to make copies of 
all XENIX installation diskettes, and hand copy 
the label information. (The Diagnostics diskette 
has a copy utility that you can use. See the 
Altos 586 Computer System Diagnostic Manual for 
information.) Store the originals in a safe 
place. 

4. Assemble the copied set of XENIX installation 
diskettes. Installation diskettes are labeled as 
follows : 

XENIX Root File System 
XENIX Utilities 
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NOTE 



If you have the optional XENIX Development 
Systenif you will also receive additional 
diskettes, such as XENIX Development System 
Utilities and the C compiler. See the Xenix 
Development System Operations Guide for more 
information. 

If you are not familiar with handling floppy diskettes, 
see the Altos 586 and 986 Computer Systems Operator's 
for instructions. 



Installing the XENIX Operating System (for the first 
time on the hard disk) is summarized here. 

Detailed installation procedures follow. 

1. Start up (boot) the system from your copy of the 
XENIX Root File System diskette. 

2. Load the utilities from the Utilities diskette. 

3. Optionally, reconfigure (set up) the ports. 

4. Create or change user login accounts. 

5. Optionally, install the XENIX Development System, 
WorkNet communication network package, or any 
application software packages. (Refer to particu- 
lar Altos or vendor manuals for installation in- 
structions. ) 

6. Set up the system to display "login" on the other 
terminals so other users can use the system. 



Allow one-half to one hour to install the XENIX opera- 
ting system for the first time. If you stop the in- 
stallation before it is completed, the next time you 
work with the system a message indicates the system was 
not shut down properly. In this event, refer to Re- 
covering from Interrupted Installation at the end of 
this chapter. 

If you encounter problems or error messages not de- 
scribed in this manual (either during or after software 
installation), run the system diagnostic tests. See 
the Altos 586 Computer System Diagnostic Manual for 
instructions. 



Installation 



During installation, you can correct typing errors 
easily. Correct a single character by pressing the 
Backspace key. Erase a line with the Delete or Rubout 
key. 

Note that the screen on the Altos II terminal automati- 
cally turns off (blanks) if there is no input from the 
keyboard or the computer for 15 minutes. You can 
restore the screen display by pressing any key on the 
keyboard. 



1. 



2. 



Turn on the power switchr or with the power on, 
turn it off, then back on. You will see the fol- 
lowing monitor sign-on message. Prepare to press 
any key when you are prompted. 




Monitor Version n.nn 
Press any key to interrupt boot 



If you do not get the monitor sign-on message, 
check that your console is properly set up and 
attached to the computer system. (Refer to Con- 
necting Additional Terminals and Printers in the 
Altos 586 and 986 Computer Systems Operator's 
Guide . ) 

If you press a key in time, you will see the 
display in Step 2. If not, press the RESET but- 
ton, and press any key when prompted. 

When you see the following display, insert your 
copy of the diskette labeled "XENIX Root File 
System" into the disk drive. Enter 2 to boot from 
the floppy diskette. 




Enter 



[1] to boot from Hard Disk 
[2] to boot from Floppy Disk 
[3] to enter Monitor 



Enter option: 2 
Booting From floppy disk 



After a delay of about 45 seconds, the following 
message appears. 



/ XENIX vn.na 



/ mem = nnnk 



The screen then displays the Welcome to XENIX 
menu. 




HKLOONB TO ZBHIZ 
Version 3.ta 



Install XBHIZ for the first tiae on your coaputer 
Dpdate your coaputer systea to XENIX version 3.1a 
Restore data to the hard disk froa cartridqe tape 
Shut down the systea 
Bzit to the XBHIX shell 



Enter option (a, br 



d, or e) and press RBTQRII: 



Enter a <CR> 

The screen displays 



Installing XENIX will overwrite ALL data on 
the hard disk. 

Do you want to continue? (y/n) 



Because this is the first time you are installing 
the XENIX operating system, your hard disk does 
not have any data on it. 



Enter y <CR> 

The system then asks 



/ What size disk (megabytes) are you in- 
/ stalling? (10, 20, 30 or 40) 

This question refers to the size of the hard disk. 
The computer model number has a "dash number" at 
the end that tells the hard disk size in mega- 
bytes. For example, the 586-10 has 10 megabytes, 
the 586-20 has 20 megabytes, and so on. 

For our example, we will enter 20 <CR>. 

Enter the size of your hard disk. 

The screen displays 



Do you want a standard swap size and/or 
number of files? (y/n) 

(Normally you will want to answer "yes" to 
this question.) 



This question refers to development systems that 
run very large application programs on the com- 
puter and need a large swap area. Most of the 
time you want the standard swap size. 

Enter y <CR> 

During the next phase of installation, the com- 
puter checks the hard disk, makes the file system 
on the hard disk, and then checks the file system. 

The screen displays messages about what the com- 
puter is doing. These messages indicate that this 
phase is going well. 

The system may find a disk sector that should not 
be used. The system flags that sector so that it 
is not used in the future, and displays informa- 
tion about that sector. 

When the computer checks the file system, the 
screen displays 



/dev/hd0b 

** Phase 1 - Check Blocks and Sizes 
** Phase 2 - Check Pathnames 
** Phase 3 - Check Connectivity 
** Phase 4 - Check Reference Counts 
** Phase 5 - Check Free List 



nn files nnn blocks nnn free 



The file system on the hard disk is correct. 

Copying the system files to the hard disk... 

Creating the special system files on the 
hard disk. . . 



If the file system on the hard disk is incorrect, 
the system will tell you. You should turn your 
system off, then back on, and try the installation 
procedure again. If this does not correct the 
problem. Contact your dealer. 

If the file system is correct, the screen dis- 
plays. 



** Rebooting ** 



XENIX vnn.n 



mem = nnnk 



Remove the "XENIX Root File System" diskette 
and store it in a safe place. 

Please insert the diskette labeled "XENIX 
I Utilities" and press RETURN. 



So far, so good. The XENIX Root File System is 
installed on the hard disk. 

8. Remove the XENIX Root System diskette and store 
it. 



INSTALLING 
A SECOND 
HARD DISK 



9. 



If you do not see "** Rebooting **," your hard 
disk has not been initialized correctly. Try 
repeating the installation process from the begin- 
ning. If this does not work, consult your Altos 
Dealer. 

Insert your copy of the diskette labeled "XENIX 
Utilities" and press <CR>. 

As utilities are copied from diskette to hard 
disk, you will see messages of the form: 




X filename, nnnnn bytes, nn tape blocks 



You will also see messages saying that a file has 
been linked to another file. These messages are 
for information only. 

NOTE 

Do not remove the diskette until the system 
tells you to remove it and the red indicator 
light on the disk drive goes off. 

After the last file has been copied to hard disk 
from the diskette, the display of file names 
stops. You will see the message. 



Remove the "XENIX Utilities" diskette and 
store it in a safe place. 



10. Remove the XENIX Utility diskette and store it. 

11. Then the screen displays 

Configuring the other system files... 
The system begins this phase of installation by asking 



Do you want to install a second hard disk on your 
system? (y/n) 



If you do not have a second hard disk, enter n <CR> and 
skip this step. 
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If you have a 
puter system. 



second hard 
enter 



disk connected to your com- 



y <CR> 

NOTE 

Press the Delete or Rubout key at any time to 
abort installation o£ the second hard disk. 

The screen displays 



What size disk (megabytes) are you installing? 
(10, 20, 30, 40) 



Enter the size o£ the second hard disk, and press 
<CR>. 

Next, the screen displays 



Do you want a standard number of files on the 
second hard disk? (y/n) 

(Normally, you will want to answer "yes" to this 
questions. ) 



This question refers to development systems that run 
very large application programs and need a different 
number of files. Most of the time you want the stan- 
dard number of files. 

Enter y <CR> 

If you answer "n" to the above question, the screen 
displays 

How many files (i.e., i-nodes) do you want on the 
second hard disk? 



The default for a 10 or 20 megabyte disk is 6000 i- 
nodes, for a 30 or 40 megabyte disk is 10000 i-nodes. 

XENIX then sets up the file system on the second hard 
disk, and periodically displays messages about what it 
is doing. 
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When the system finishes installing the second hard 
disk, the screen displays 



The file system on the second hard disk is 
correct. 



See "Recovering from Interrupted Installation" later in 
this chapter if the file system check does not occur as 
described. 

During the next phase of installation, the system will 
ask if you want to do the following tasks: 

1. Change the descriptions of the ports (reconfigure 
them) so the system will recognize additional 
terminals and printers 

2. Create accounts for yourself and current users. 

In the future, you will only be able to do these tasks 
from the Business Shell as the system administrator or 
"super user"; we'll explain more about the super user 
in Chapter 4. 



CONFIGURING 
THE PORTS 



The screen displays 



Do you want to change the description of the 
terminal (s) and printer (s)? (y/n) 



The ports on the Altos 586/986 system are already set 
up for Altos terminals. Port 6 is set up as the 
printer port. Table 1-1 shows port configuration 
(ports 7-10 are for the 986 system only) . 
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Table 1-1 • Port Configuration 







dgvxcc 


Termxnax 


Printer 


Baud 


Parity 


wora 


noaen / 


Nanc 


Nanc 


Type 


Type 




Rate 


Len 






con SOX 6 


ternunax 


axcosz 




oca a 












terminal 


ax uosz 




oca a 








P(»T 3 


tty3 


termincQ 


altos2 




9600 








PORT 4 


tty4 


teninal 


altos2 




9600 








PORT 5 


ttyS 


terminal 


altos2 




9600 








FORT 6 


tty6 


printer 




default 


9600 


nope 


8 bits 




PORT 7 


tty7 


terminal 


altos2 




9600 








PORT 8 


ttyS 


terminal 


altos2 




9600 








PORT 9 


tty9 


terminal 


altos2 




9600 








PORT 10 


ttylB 


terminal 


altos2 




9600 









When you first install XENIX, you may need to reconfi- 
gure a port to tell the system what kind of terminal 
and/or printer is attached to the port. After the 
initial installation, use the Port Configuration pro- 
gram described in Chapter 4 to make future changes. 

If you need to change a port's setting, enter 



y <CR> 



The Port Configuration program display appears. See 
Chapter 4, Configuring the Ports, for instructions. 
Ignore the first two steps, which tell you how to 
access this program from the Business Shell. 

When you are finished with port configuration, return 
to the next section. 

If you do not need to change port settings, enter 
n <CR> 



and continue with the next section. 



CREATIHG AND 
CHANGIHG OSBR 
ACCOUNTS 



Next, the screen displays 




Do you want to add more users and/or change 
existing user accounts? (y/n) 



You should create a user account login name for each 
person using the system when you first install XENIX. 
In the future, when you want to add or change user 
accounts, you can access this program from the Business 
Shell. 
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Enter y <CR> 

The User Administration screen appears (see Figure 4-2) 

See Chapter 4, User Administration for instructions. 
Ignore the first three steps, which tell you how to 
access this program from the Business Shell. When you 
finish, return to the next paragraph to continue in- 
stallation. 

After you set up user accounts using the User Adminis- 
tration program, the installation proceeds and your 
screen displays 




Checking the file system on the hard disk 



/dev/hd0b 

** Phase 1 - Check Blocks and Sizes 
** Phase 2 - Check Pathnames 
** Phase 3 - Check Connectivity 
** Phase 4 - Check Reference Counts 
** Phase 5 - Check Free List 

nn files nnn blocks nnn free 



Xenix Version n.nn is correctly installed on your 
computer 



If XENIX is not correctly installed, the system will 
tell you. You should then turn your system off, then 
back on, and try the installation procedure again. If 
this does not correct the problem, contact your dealer. 



Next, the XENIX Options menu appears on the screen. 
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USING 
THE XENIX 
OPTIONS MENU 



Installing 

Other 

Software 



Displaying 
■login;" on 
Other 
Terminals 



The XENIX Options menu allows you to install additional 
software (such as the XENIX Development System or Work- 
net), set up the system so other users can log in, or 
shut down the system. 



select one oC the Eollowing options: 

a. Display the "loqin* proapt on all terainals in the systea 

b. Continue Vj.th only one usee and install other software packages 

c. Shut down the systea 



If you purchased the XENIX Development System, WorkNet 
communication package, or other appliction software, 
enter 



and install them now. Refer to the appropriate manual 
for instructions. 

To display the "login" prompt on other terminals in the 
system (so other users can log in and use the system) , 
enter 

a <CR> 

Then the screen displays 



I think its Day Date Time Year 

Enter date (yymmdd) or press RETURN if ok: 

Enter time (hhmm) or press RETURN if ok: 
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To change the date and time, use the following format: 



yy = current year 

mm = current month 

dd = current day of month 

hh = hour (24-hour clock) 

mm = minutes 



For example, enter May 1, 19 84 as 

/ 840501 <CR> 

and enter 4:30 pm as 

/ 



Shutting 
Dcfwn the 
System 



Returning to 
the Options 
Henu 



1630 <CR> 



The screen displays the date and time as you set them, 
and the "login" prompt then appears. 



Altos586 login: 



Now the system is set up for other users. 

If you want to turn the power off, first you should 
shut down the system; enter 

C <CR> 

To return to the Options menu after you are finished 
with an option, if needed, log in as root, and enter 

options <CR> 



In the future, if you need to access the Options menu 
you must be logged in as the super user. From the 
System Administration menu of the Business Shell, type 
p. Go to System Maintenance Mode. At the XENIX prompt 
(#) , enter 



options <CR> 
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RECOVERING 
FROM 

IirrERROPTED 
INSTALLATION 



If installation is interrupted, you may receive the 
following message after you press the RESET button. 



/ The system was not shut down properly. 

/ The root file system will be cleaned. 

/ (Type "no" only if you want to avoid cleaning.) 

This process begins automatically after about 5 sec- 
onds. XENIX validates the consistency of the disk file 
system, which may have been damaged, and automatically 
repairs it. If there is no damage, you will see the 
following : 



/dev/root 
** Phase 
** Phase 
** Phase 
** Phase 
** Phase 



1 - Check Blocks and Sizes 

2 - Check Pathnames 

3 - Check Connectivity 

4 - Check Reference Counts 

5 - Check Free List 



nn files nnn blocks nnn free 



If the file system was damaged, XENIX repairs it auto- 
matically and displays a log of the corrections that 
have been made. 



After the "** Rebooting **" message appears, the system 
may ask you to insert the Utilities diskette and press 
the Return key. 

If nothing appears on the screen after the message 
"Booting from Hard Disk," the installation procedure 
has failed. Start the installation procedure again by 
booting from the diskette labeled "XENIX Root File 
System. " 
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Logging In and Logging Out 



CONTENTS 
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LOGGING IN 



To use your Altos computer system, you need to log in. 



SETTING AND 

CHANGING 

PASSWORDS 



Find out your user name from the system administrator. 
At the login prompt, type your user name and press the 
Return key. For example. 



IV 

/ Altos5 86 login: robert <CR> 



Or, you may log in by responding to a system prompt: 



$ login robert <CR> 



To protect files you own, you need to have a password. 
When you first log in, no password is assigned. You 
can set a password using one of the following proce- 
dures. Thereafter, each time you log in, you will be 
asked for your password. To maintain security, the 
password you type won't show on the screen. 

To set or change a password, type b. Change Password. 
The screen displays 



Changing password for (your login name) 

New password: Type in any desired password <CR> 

Retype new password: Retype in same password <CR> 



[Type RETURN to continue] 



If you are changing your password, you will be prompted 
for the old password. Enter the old password and press 
the Return key. Then you are asked to type in the new 
password. 



The next time you log in, you will be asked for the 
password. 



NOTE 



Enter 6 or more characters for your password. 

If you forget your password, you cannot access your 
files. The system administrator can remove your pass' 
word without knowing what it is, and you can enter a 
new one. 
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LOGGING ODT 
OR QUITTING 



To log out from the Business Shell Main Menu, enter q, 
Quit. To log off from the UNIX Shell (the # or $ 
prompt) , enter <Control-D> <CR>, 
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ACCESSING TBB | This section describes programs you can use from the 
BUSINESS SHELL Business Shell menu. You use these programs to create 
MENU SYSTEM directories and files, shut down the system, and save 

and restore files. Figure 3-1 shows the organization 

of the Business Shell menus. 



THE ALTOS BUSINESS SHELL 



BASIC UTILITIES 

A. CHANGE DIRECTORY 

B. CHANGE PASSWORD 

C. LIST DIRECTORY 

D. CREATE A DIRECTORY 

E. REMOVE A DIRECTORY 

F. EDIT A FILE (ad) 

G. REMOVE A FILE 

H. COPY &/0R COMBINE FILES 

I. DISPLAY FILES 
J. PRINT FILES 



SYSTEM AND HELP 


K. 


SYSTEM ADMINISTRATION 


L. 


ELECTRONIC MAlL 


M. 


RUN A PROGRAM 


Q. 


QUIT (logout) 


R. 


HELP 



SYSTEM ADMINISTRATION 



SYSTEM MANAGEMENT 



A. USER ADMINISTRATION 



B. BACKUP/RESTORE FILES 



C. PORT CONFIGURATION 



DIRECTORIES AND FILES 



E. CHANGE DIRECTORY 

F. LIST DIRECTORY (long) 

G. CHANGE FILE PERMISSIONS 

H. CHANGE FILE OWNERSHIP 

I. CHANGE FILE GROUP 
J. FILE SPACE 



UTILITIES 



K. TIME AND DATE 

L. WHO IS ON THE SYSTEM? 

M. DISPLAY PROCESS 

N. KILL PROCESSES 

O. BECOME SUPER-USER 



S. SHUT DOWN THE 
SYSTEM 



BACKUP/RESTORE FILES 



A. FLOPPY DISKETTE BACKUP/RESTORE 



B. MAGNETIC TAPE BACKUP/RESTORE 



The 486 system does not have this option. 



FLOPPY BACKUP AND RESTORE 



A. BACKUP FILE(S) AND/OR □IRECTORY(S) 

B. RESTORE FILE(S) 

C. RESTORE THE ENTIRE DISKETTE 

D. DISPLAY FLOPPY DISKETTE DIRECTORY 

E. FORMAT A FLOPPY DISKETTE 



Figure 3-1 • Organization of the Business Shell 
Menu System 

Most user accounts are set up so you log in to the 
Business Shell. If this is not the case, you can 
access the Business Shell in one of the following ways: 

o Log in as user <CR> (for regular user) 
o Log in as adniin <CR> (for super user) 
o From the UNIX Shell (either the # or $ prompt), 
type bsh <CR>, 
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Using Xenix on a Regular Basis 



3-2 ACCESSING THE BUSINESS SHELL MENU SYSTEM 

3-3 How to Use the Business Shell 

3-3 Past Mode/Slow Mode 

3-3 BASIC UTILITIES 

3-5 Name a File or Directory 

3-7 Create a Directory 

3-9 List a Directory 

3-10 Change a Directory 

3-11 Remove a Directory 

3-12 Create and Edit a File 

3-13 Display a File 

3-14 Copy and Combine Files 

3-16 Print a File 

3-17 Remove a File 

3-18 Change a Password 

3-19 USING ELECTRONIC MAIL 

3-20 Sending Mail 

3-20 Receiving Mail 

3-21 RUNNING A PROGRAM 

3-22 The "l" Command 

3-22 OBTAINING HELP WHILE IN BUSINESS SHELL 

3-23 Business Shell Commands 

3-24 Business Shell Menus 



ACCESSING THE 
BUSINESS SHELL 
MEND SYSTEM 



This section describes programs you can use from the 
Business Shell menu. You use these programs to create 
directories and files, shut down the system, and save 
and restore files. Figure 3-1 shows the organization 
of the Business Shell menus. 

I THE ALTOS BUSINESS SHELL 



BASIC UTILITIES 



A. CHANGE DIRECTORY 

B. CHANGE PASSWORD 

C. LIST DIRECTORY 

D. CREATE A DIRECTORY 

E. REMOVE A DIRECTORY 

F. EDIT A FILE Iwll 

G. REMOVE A FILE 

H. COPY a/OR COMBINE FILES 

I. DISPLAY FILES 
J. PRINT FILES 



SYSTEM MANAGEMENT 
A. USER ADMINISTRATION 



B. BACKUP/RESTORE FILES 

C. PORT CONFIGURATION 



SYSTEM AND HELP 


K. 


SYSTEM ADMINISTRATION 


L. 


ELECTRONIC MAIL 


M. 


RUN A PROGRAM 


Q. 


QUIT (logout) 


R. 


HELP 



SYSTEM ADMINISTRATION 



DIRECTORIES AND FILES 

E. CHANGE DIRECTORY 

F. LIST DIRECTORY (longl 

G. CHANGE FILE PERMISSIONS 

H. CHANGE FILE OWNERSHIP 
CHANGE FILE GROUP 

J. FILE SPACE 



UTILITIES 
K. TIME AND DATE 
L. WHO IS ON THE SYSTEM? 
M. DISPLAY PROCESS 
N. KILL PROCESSES 
O. BECOME SUPER-USER 



S. SHUT DOWN THE 
SYSTEM 



BACKUP/RESTORE FILES 
A. FLOPPY DISKETTE BACKUP/RESTORE 



B. MAGNETIC TAPE BACKUP/RESTORE 



TAPE BACKUP AND RESTORE 

A. BACKUP THE ENTIRE HARD DISK TO TAPE 

B. RESTORE INDIVIDUAL FILEISI FROM TAPE 

C. DISPLAY TAPE DIRECTORY 



FLOPPY BACKUP AND RESTORE 

A. BACKUP FILEISI AND/OR DIRECTOR Y(SI 

B. RESTORE FILE(SI 

C. RESTORE THE ENTIRE DISKETTE 

D. DISPLAY FLOPPY DISKETTE DIRECTORY 

E. FORMAT A FLOPPY DISKETTE 



Figure 3-1. Organization of the Business Shell 
Menu System 

Most user accounts are set up so you log in to the 
Business Shell. If this is not the case, you can 
access the Business Shell in one of the following ways: 



o Log in as user <CR> (for regular user) 
o Log in as admin <CR> (for super user) 
o From the UNIX Shell (either the # or $ prompt) , 
type bsh <CR>. 
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The Business shell contains programs for file manage- 
ment that a regular user needs, and system management 
utilities that an administrator needs. These programs 
ask you for appropriate information, and then do the 
necessary work for you. The programs are grouped on 
menus so you can access them efficiently. 

To select a menu item, type the letter to the left of 
that item. Sometimes another menu appears with addi- 
tional selections that you can choose (e.g., Back- 
up/Restore Files) . 

To return to the previous menu, press the Return key 
when any menu prompt is displayed. 

HOTE 

Do not press the Return key when you make a 
selection; type only the letter. If you 
press the Return key after typing your selec- 
tion, you are returned to the previous menu. 

The Business Shell operates in either fast mode or slow 
mode. 

In the fast mode, when you type a letter for a menu 
item, the system responds immediately. You do not need 
to press the Return key. 

In the slow mode, the system does respond until you 
press the Return key. 

In either mode, when you wish to enter a command that 
does not begin with a lower-case alphabetic character, 
such as ?, ??, or Name?, you must end the command with 
a carriage return. 

To change from the fast mode (the factory or default 
setting) to the slow mode, enter 



menu prompt > ?iiode 

Mode = FAST; change to slow? (y/n) y 



Basic utilities you can access include 



0 


Change 


directory 


0 


Change 


password 


0 


Create 


a directory 


0 


List directory 


0 


Remove 


a directory 


0 


Create 


and edit a file 


o 


Remove 


a file 



o Copy and/or combine files 
o Display files 
o Print files 

Figure 3-2 shows the Business Shell main menu, which 
contains Basic Utilities and System and Help selec- 
tions. 



. [Start] 

' Oser : adain 



Basitt«ss Shell 



Med Jun 29 ■2:32 1983- 



Baaic Ptilitiea 

a. Change Directory f. Edit a file (ed) 

b. Change Password g. Reaove a Pile 

c. List Directory h. Copy t/or Coabine File 

d. Create a Directory i. Display Piles 
_e. Reaove a Directory j. Print Piles 

Syate^ and Hglp 

k. Systea Adainistration q. Quit (logout) 

1. Electronic Hail r. Help 

a. Ron a prograa 



Type a letter to aake your aelectlon> 



Figure 3-2. The Business Shell Main Menu 



The parts of the menu are defined as follows: 



1 


The 


name of the menu 


2 


The 


current user (your login name) 


3 


The 


complete pathname 


4 


The 


current date 


5 


The 


basic utilities 


6 


The 


system and help utilities 


7 


The 


menu prompt. 



Name a File 
or Directory 



Figure 3-3 shows an example of the directory and file 
structure of the XENIX operating system. Directories 
and files are arranged in a hierarchical structure, 
with root as the top directory. The full name of any 
directory or file begins with a slash (/) , which de- 
notes the root (or topmost) directory. Your direc- 
tories and files are located in /usr. 




Figure 3-3. Directory Structure 



Usually, a directory contains files on the same sub- 
ject. Each directory and file must have a file name 
that you assign, A file name must be unique, and can't 
have the name of the directory in which it resides. A 
directory name or a file name can have up to 14 charac- 
ters. Because the following characters have special 
functions, do not use them in file names: 



asterisk 


* 


left square bracket 


[ 


comma 




right square bracket 


] 


semicolon 




slash 


\ 


colon 




backslash 


/ 


question mark 


7 


left single quote 


\ 


exclamation point 


I 


right single quote 


1 


left parenthesis 


( 


double quote 


n 


right parenthesis 


) 


space 





When you first create files, you may wish to place all 
of them in /usr/mydirectory (/usr/acct or /usr/alice in 
the figure). However, as you become more adept, you 
can have directories and files that are many levels 
below /usr/mydirectory. 
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When you are working in a directory or file, it is 
called the "current" directory. To create or access a 
directory or file in your current directory, type the 
file name. To create or access a directory or file not 
in the current directory, you must specify the full 
pathname. 

For example, there are many ways to access the file 
"pettycash" in Figure 3-3. One way is to change your 
current directory to /usr/acct/payables. You can then 
access the file by typing "pettycash. " 

Another way to access "pettycash" is to specify the 
full pathname: /usr/acct/payables/pettycash. A full 
pathname consists of a series of one or more direc- 
tories and a single file name. Be sure to include the 
initial slash (/) and the slash after each directory 
along the path. 
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Create a 
Directory 



You can set up a directory to contain related files. 
Then you can go directly to a set of files; this is 
similar to opening a file drawer devoted to one sub- 
ject. 

To create a directory, type d, Create a Directory. The 
prompt "Name of directory(s) to create?" appears. En- 
ter the name of the directory you wish to create, and 
press the Return key. 



[Start] 
User: adain 



Buslmss Shall 
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a. Change Directory 

b. Change Pasawocd 
>aw List Directory 

-(d.jCreate a Directory 
>a<^Resove a Directory 



Baain [ltilihi>« 



Edit a file (ed) 

Reaove a Pile 

Copy k/or Coabine Pile 

Display Files 

Print Piles 



Syatrm and B.lp 
Systes Adsinistration q. Quit (logout) 

Electronic Hail r. Belp 

Run a proqras 



Type a letter to eake your selection> 



[Start] 
Ossri ateio 



Business Shell 



Ned Job 2» »2t32 19B3 



— nmttlaa 

a. Change Directory t. Edit a file (ed) 

b. Change Password g. Bewe a file 

c. Ust Directory h. Copy k/ot Coabine File 

d. Create a Directory i. Display Piles 

e. leMve a Directory J. Print Piles 

"Y-*— "«'° 

k. Systea A^nistratlon q. Quit (logout) 

of dircctory(s) to create? 




To verify that the directory was created, change to the 
new directory, and list the directory. 



After you have created a directory, you can create new 
files within the directory. First, to access the new 
directory, enter a. Change Directory. You are prompt- 
ed: "Change to which directory?" Enter the new direc- 
tory name, and press the Return key. The Basic Utili- 
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ties menu now relates to the new directory. Note that 
the pathname in the upper-right corner (above the date) 
ends with the new directory. If you wish, you can type 
f. Edit a file, to add a new file to the directory. 

If you have two hard disks and are working on the first 
hard disk, you can create/access directories and files 
on the second hard disk. Select a, Change Directory, 
and enter 

/usr2 <CR> 

Your working directory is now on the second hard disk. 

You can, if you wish, work from the first to the second 
hard disk. For example, if you are working on the 
first hard disk and want to create a directory named 
accounting on the second hard disk, select d. Create a 
Directory, and enter 

/usr2/accotmting <CR> 
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List a 
Directory 



To list the contents of a directory, type c, List 
Directory. Directories within directories are indi- 
cated by a slash (/) after the name, for example new- 
user/. 



[Start] 
Usee : adaln 



Businaaa Shall 
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Edit a file (ed) 
Reaove a File 
Copy fc/or Combine File 
Display Piles 
Print Piles 



Baaic utilifiM 
Change Directory f. 
Change Password g. 
List Directory h. 
Create a Directory i. 
Resove a Directory j. 

Sy«tn« and HniB 
Systea Adainistration q. Quit (logout) 

Blectronic Hail r. Belp 

Run a prograa 



Type a letter to sake your selection) 



Directory: /etc 

asktiae* init* atab shutdown* 

checklist aenusys.bin newuser/ systeaid 

getty* akfs* agroup taracap 

group aknod* apasswd ttya 

haltaya* aotd passwd ttytype 

inlr* aount* rc* uaount* 



update* 

utap 

wall* 
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Change a 
Directory 



To change to another directory, type a, Change Direc- 
tory. The prompt "Change to which directory?" appears. 
Enter the name of the directory you wish to access, and 
press the Return key. The system changes your current 
directory and places the name of the current directory 
above the date in the upper-right corner of the Busi- 
ness Shell menu. 



(Start] 
Usee: adain 



BuaiMU Shell 



Wed Jun 29 02:32 1983 



tonic IH:ilil-i|.B 

Change Directory £. Edit a file (ed) 

Change Password g. Reaove a Pile 

c. List Directory h. Copy */or Combine Pile 

d. Create a Directory i. Display Piles 

e. Reaove a Directory j. Print Piles 

Syatoi and a«lB 

k, Systea Adainistration q. Quit (logout) 

1. Blectronic Hall r. Belp 
a. Run a prograa 



Type a letter to aake your selection> 
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a. 


Change Directory 


f. 


Edit a file (ed) 


b. 


Change Password 


g. 


Reaove a Pile 


c. 


List Directory 


b. 


Copy i/or Coabine Pile 


d. 


Create a Directory 


i. 


Display Piles 


e. 


Reaove a Directory 


j. 


Print Piles 




Syntmm jind B»lp 




k. 


Systea Adainistration 


g- 


Quit (logout) 


1. 


Electronic Hail 


r. 


Belp 


a. 


Run a prograa 







Type a letter to aake your selection) 
Change to which directory? 
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Remove a 

Directory 



To remove a directoryr type e. Remove a Directory. The 
prompt "Name of directory (s) to remove?" appears. En- 
ter the directory (s) and press the Return key. Note 
that you cannot be working in the directory that you 
want to remove. Check your current pathname, which is 
displayed in the upper-right corner above the date. If 
necessary, change the directory by selecting the Change 
Directory menu item. 



IStartl 
User: admin 



BasiMM Shall 



Wed Jun 29 12:32 1983 



Change Directory f. Edit a file (ed) 

Change Paasvord q. Reaovc a Pile 

t.i»t Directory h. Copy i/or Coi^ine Pile 

Create a Directory i. Display Pile* 

Reaove a Directory j. Print Pi lea 

Sv«f«. ,nA H.lp 

Systea Adainistration q. Quit (logout) 

electronic Nail r. Belp 
Run a prograa 



Type a letter 



aake yout aelection> 



rv 



[Start] 
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a. Change Directory 

b. Chaaga Paaavord 

c. List Directory 

d. Create a Directory 

e. RaaoTe a Directory 



Edit a file (wl) 

ReaoTa a Pila 

Copy t/or Coablna Pila 

Diaplay Piles 

Print Piles 



Sy««-i» H.lp 

Systea Adainistration q. Quit (logout) 



aaa of directory(s) to reaove? 



After removing a directory, type c. List Directory, to 
verify that it was removed. 

CAUTION 



When you remove a directory, all of the files 
in that directory are also removed. If you 
Wcuit to save a file, copy it to another 
directory before you remove the first direc- 
tory. 
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Create and 
Edit a File 



A computer file is similar in concept to a paper file; 
they both contain information. A file can contain the 
text of a letter, financial data, or a list of cus- 
tomers. A file can contain as little or as much infor- 
mation as you want. 

To create and edit a file, type f , Edit a File (^d) • 
The prompt "Name of file(s) to invoke editor on?" 
appears. Enter the file name(s) and press the Return 
key to start your editing session. Refer to Invoking 
Ed, the Text Editor in Chapter 5 for editing instruc- 
tions. 



I start I BuiMu SIwll / 

User: adnin Wed Jun 29 02:32 i983 



Bftsit Utiiit 

a. Change Directory 

b. Change Password 

c. List Directory h. Copy i/ot Conbine File 

d. Create a Directory i. Display Piles 

e. Remove a Directory j. Print Files 

Systea and Help 
k. Systea Adainistration q. Quit (logout) 

1. Electronic Nail r. Help 

n. Run a prograa 



Type a letter to aake your selectio 
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Display a 
File 



To display a file, type i, Display Files. The prompt 
"File(s) to display?" appears. Enter one or more 
files, each separated by a space and press <CR>. Enter 
the full pathname of the file; if it's in your current 
directory, just enter the file name. 

The contents of the first file is displayed. If a file 
is longer than one screen, " — More — " and the percent- 
age of text that has been displayed appears at the 
bottom of the screen. Press the Space Bar to see the 
next screenful. Press the Return key to display each 
subsequent line in the file. 

If you enter more than one file name, press <CR> to 
view the next file. 



You can exit the file at any time without affecting its 
contents by pressing the Delete (or Rubout) key. 



[Start] 
Ds*r: adain 



BnslnMa Shell 
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Banic ntilitiftii 

a. Change Directory f. Edit a file (ed) 

b. Change Paanord q. Reaove a File 

c. Liat Directory ti. Copy t/or Coabine Pile 

d. Create a Directory ri.j Display Files——— 

e. Reaore a Directory Print Files 

SyatKM and H»lp 

k. Sjfatca Adainiatration q. Quit (logout) 

1. Blectronic Hail c. Help 

Ron a pcograa 



Type a letter to aake your selectioa> 
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Copy and To copy or combine files, type h, CoTpy and/or Combine 

Combine Files. The prompts for the names of the "old file(s)" 

Files and the "new file" appear. For example, if you enter a 

single old file, june.l and a single new file, decem- 
ber.l, your directory now contains two files with dif- 
ferent names and identical content. You have a back-up 
file for security. Should you destroy part of a file, 
you can retrieve the other copy. Note that the old 
file contents will write over contents (if any) in the 
new file. 



/ — f 

(Start] —!■<■■ flkaU 

user: adaln Haa Jun 2» (2:32 H«3 

a. Change Directory f. edit a file (ed) 

b. Change Password Reaove a File 

c. List Directory ftj Copy i/or Conbine Pile — — . 

d. Create a Directory >: Display Piles 

e. Reaove a Directory j. Print Piles 

Svxtmm mJ H«lp 
k. Systea Adainistration q. Quit (logout) 
1. Blectronic Nail z. Help 
a. Run a prograa 

Type a letter to aake your selection} 

y ( 








>w— —-^ 

old file(s)i 

> \ 





The names of the old and new files must be different. 
If you copy two or more files into a new file, the new 
file contains all of the old files attached one after 
the other in the order you entered them. The old files 
still exist. 
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To cop7 files from the first to the second hard disk, 
enter 

old file(s) /usr/dirnane/f ilenane 
new file /usr2/dlrname/f ilename 

where 

dirname = the name of the directory. 

filename = the name of the file you wish to copy. 

You can omit the new name if you want the file name to 
be the same on both disks. 

For example, to copy a file named sales (in the ac- 
counting directory on the first disk) , enter 

old file(s) /usr/accounting/sales 
new file /usr2/accounting 



3 
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Print a File 



To print files, type j, Print Files. The prompt 
"File(s) to print?" appears. Enter the name of the 
file(s) to be printed and press <CR>. (Your XENIX 
system must be configured to a connected printer.) 



V Y 

IStartI —in— SbaU / 
User: adain Had Jun 29 f2>32 1983 

BMiS UtiliUM 

a. Change Oltactocy t. Edit a file (cd) 

b. Chang* Passvocd 9. Ifmmt a PiXa 

c. bist Diccctoty h. Copy t/ot Coabin* File 

d. Ciaata a Dliactocy L, Display Plica 

k. SystaB Adainistration q. Quit (loqout) 
1. Blactronic Hail r. Balp 
■. Run a proqcaa 

1 Type a latter to aake your **lection> 

> — . — 4, 








Y — ^ 

(Start] MsiBMa ahaU / 1 

User: adain Wed Jun 29 12:32 1983 1 

TltUr tlfilirltt I 

a. Change Directory f. Edit a file (ed) 1 

b. Change Password g. Reaove a Pile 

c. List Directory h. Copy t/or Coabine Pile 

d. Create a Directory i. Display Piles 

e. Reaove a Directory j. Print Files 

Rfmtmm and ll«lp 

k. Systea Adainistration q. Quit (logout) 
1. Electronic Mail r. Help 
m. Run a prograa 

1 File(s) to print? 

> -J, 
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Remove a File 



To remove a file, type g, Remove a File. The prompt 
"Name(s) of file(s) to remove?" appears. Enter the 
file name or multiple file names each separated by a 
space, and press <CR>. List the directory to verify 
file removal. 



If you enter a directory name instead of a file name, 
the word "directory" appears and nothing is deleted. 



"71 



I start I 
Usee: adiain 



■oslBMM Sbmll 
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a. Change Dicectory 

b. Change Password 

c. List Directory 

d. Create a Directory 

e. Remv* a Directory 



L, edit a file (ed) 
(q^ Remove a Pile — 
Tr: Copy i/ot Coabin 



Syon— and Help 

Systea Adainistration q. Quit (logout) 

Electronic nail r. Help 
Run a prograa 



Type a letter to sake your selection} 



(Start! 
User: admin 
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Raaie Utilities 



Edit a Eile (ed) 
Remove a File 
Copy k/oc Combine Pile 
Display Piles 
Print Piles 



Change Directory 
Change Password 
List Directory 
Create a Directory 
Remove a Directory 

gY«f — and Hf\p 

System Administration q. Quit (loqout) 



Name(s) of file(s) to remove? bolse.memo 



(Type RETTJRN to continue) 
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Ch£uige a 
Password 



To change your password, type b. Change Password, You 
are prompted to enter your old password. You are asked 
to enter a new password, and then asked to retype the 
new password. The password does not show on the 
screen. 



[Start! 
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aa«ic Utilitiea 

Change Directory f. Edit a file (ed) 

Change Password g. Reaove a Pile 

List Directory h. Copy t/or Coabine File 

Create a Directory i. Display Piles 

Reaove a Directory j. Print Files 



SyatM and H.lp 

k. Systea Adainistration q. Quit (logout) 

1. Electronic Hail r. Belp 
a. Run a prograa 



Type a letter to aake your selection) 
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Baite ntilltiBi 

a. Change Dlcectory f. Edit a file (cd) 

b. Change Password g. Reaove a File 

c. List Directory h. Copy &/or Coabine File 

d. Create a Directory i. Display Files 

e. Reaova a Directory j. Print Files 



Symt-^ jinH ll»lp 



changing password for adaia 
Saw password! 
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XENIX provides a convenient way for you to send and 
receive messages to other users on the system via 
electronic mail. After receiving mail, you can save 
in various places (files) or discard it. 

To send and receive mail, type 1, Electronic Mail, 
under the System and Help section of the main menu. 
The prompts "Receive mail" or "Send mail" appear. 



(Start! Bnalnasa Shall / 

User: adain Wed Jun 29 12:32 1983 



Baaie Utilitteg 

a. Change Directory t. Bdit a file (ed) 

b. Change Password q. Reaove a File 

c. List Directory h. Copy &/or Coabine Pile 

d. Create a Directory i. Display Files 

e. Reaove a Directory j. Print Files 

SyatM anri ll»lp 

Jl. Systea Adainistration q. Quit (logout) 

-Aj electronic Mail r. Belp 

V. Run a proqraa 



Type a letter to aake your selection> 



BLBCTBOBIC MAIL SEKVICBS 



a - Kaceive aail 
b - Send aail 



To send mail, type b. Enter the login name of the per- 
son (s) to whom you are writing; separate names with a 
space. Then type the message. You can use the follow- 
ing keys when typing: 

Keys Results 

Left, Right, Move the cursor 
Up, Down Arrow 

BACKSPACE Delete a character to left of the cursor 

DEL CHAR Delete a character under the cursor 

INS CHAR Insert a character at the cursor 

RETN End a line; go to beginning of next line 

When finished, send the message by entering <Control- 
D>, Press the Return key to return to the previous 
menu. 

To receive mail, type a. All messages in your mail 
file are displayed, one after the other, starting with 
the most recent one. After a message displays, a ? 
prompt appears on the command line (see the options 
below) . 

When the ? prompt displays, you have various options: 

Options Results 

<CR> Displays the next message. If there are 

no more messages, returns you to the 
previous menu 

d <CR> Deletes last message, displays next 

message displays 

m user <CR> Mails message to specified user login id 

p <CR> Displays previous message again 

q <CR> Quits, returns to prompt line 

s [file] <CR> Saves message in your current directory's 
mbox file, or the file you specify 

w [file] <CR> Writes the message (without heading) to 
your current directory's mbox file, or 
the file you specify 

X <CR> Exits to the prompt line without changing 

the message 



All of the menu items in the menu systems are programs. 
When you select a menu item you are in effect causing 
the program to execute. For example, pressing the "f" 
key in the Business Shell, causes execution of the 
XENIX "editor" program. 

To run a program, type m, Run a Program, under the 
System and Help section of the Business Shell main 
menu. You may execute a program in either the a. out or 
arbitrary file. Type a to execute the program in the 
a. out file. The a. out file usually contains the result 
of the last compilation. 
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BaBlc UtilltiM 

a. Change Directory £. Edit a file (ed) 

b. Change Password g. Reaove a File 

c. List Directory h. Copy t/or Combine File 

d. Create a Directory i. Display Files 

e. Remove a Directory j. Print Files 

k. Systea Adainistration q. Quit (logout) 
1. Electronic Mail r. Help 

Type a letter to aake your selection> 

1 i 

'X 








Y__- — Y 

[Bzecate] 

RDH A PROGRAM 

XXBEB 

a - Execute the prograa in file *a.out" 
b - Help on running pcogcau 
Iprogcaa - Run an arbitrary prograa 

Type a RCTDRN to go back to the previous loenu. 
CoaMnd> 

L — — 1 



The 

Conniand 



OBTHlHinG HELP 
WHILE IN 
BUSIHESS SHELL 



You can also run a program by entering the "1" command 
from almost all menu prompts in the Business Shell. 
When you enter "1," you exit from the Business Shell 
and can enter XENIX commands directly. Then you can 
use other XENIX commands not available through the 
Business Shell. See Moving Between Shells in Chapter i 
for details. 



The Business Shell contains Help menus for each menu in 
the system. To display Help information for the menu 
in which you are working, enter ? <CR>. The Help 
description for the menu is displayed. The commands 
that give help information are as follows: 

? <CR> Display help for current menu 

Haae? <CR> Display help for the named menu 

Nail? <CR> Display help for the "mail" menu 

?indez <CR> Display an index of the available menus 

When asking for help for a named menu (Name? <CR>) / 
capitalize the first letter of the name (so the menu 
system doesn't think you are selecting a menu item). 

Type r, Help, under the System and Help section of the 
main menu to display the Help menu. 

You have the option of selecting 

a. A list of Business Shell commands 

b, A list of menus in the system 
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IStactl 
Usee : admin 



BaaiiMU Shall 



Wed Jun 29 12:32 1983 



a. Change Dicectocy 

b. Change Password 

c. List Directory 

d. Create a Directory 

e. Reaove a Directory 



Ranic Utilitiea 



Edit a file (ed) 
9. Reaove a Pile 
h. Copy t/ot Conbin< 
1. Display Piles 
j. Print Piles 



gym-.- anri H»lp 

Systea Adainistration a. Quit ( logout) 

Electronic Nail fr^ Belp 

Run a pcoqraa 



Type a letter to aake your selection> 



Business Shell 
Commands 



[BelpJ 



aCLP IS MTAIUBLI OH THBSB SUBJECTS 



BSH is a 'uaar-friendly* aenu systea wbicb allows you to inter- 
face with the operating systea in a staple aannar. It is a nice 
interface to the operating systea for running applications and for 
systea aaintenance and adainistration. 

BSB contains 'help* aenas for each of the acnoa in the systea. 
Tou aay display an iodaz of the available acnus by selecting the Olr 
■anu, 01 yon aay issue the 7 index coaand. 

a. Balp on BSB coaaanda 



b. List of aenus in the systea 



Make a selection or type a RETURB to go back to the previous sen 



When you type a, command descriptions are displayed as 
follows : 



QOmMD TYPE 
prompt <CR> 

Menu <CR> 
<return> 



SHORT EXPLANATION 

Execute the function associated with the 
menu entry (for example, type either a, 
bf or c) . 

Go to the named menu. 

Return to the immediately preceding 
menu. By entering successive <return>s, 
you can retrace the path through the 
menus. 
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COMMAND TYPE 



SHORT EXPLANATION 



Business Shell 
Menus 



? <CR> 



?? <CR> 
name? <CR> 

I command <CR> 



?index <CR> 

?mode <CR> 
Quit <CR> 



Show the help menu for the current dis- 
play. The *?" by itself is the equi- 
valent of entering <current menu>? Re- 
turning from a help menu is accomplished 
in the same way as any other menu, by 
entering <return>. 

Display the command menu. 

Display help information for the named 
menu. 

The "I" causes immediate exit to the 
XENIX Shell. The rest of the line is 
executed in a sub-shell. An "I" alone 
initiates a sub-shell which is termi- 
nated in the normal XENIX manner <Con- 
trol-D>. By using "Ish," "Icsh," or 
"Ibsh" one may select the specific shell 
to be used; the standard XENIX Shell 
(sh) , the optional C Shell (csh) , or the 
Business Shell (bsh) . See Moving Bet- 
ween the Shells section in Chapter 4. 

Display the name of every menu in the 
current menu system. The "Dir" menu 
contains a short version of the index. 

Set mode as either fast-mode or slow- 
mode. 

Terminates the Business Shell and re- 
turns control to XENIX. 



For more information, see the detailed Help menus with- 
in the Business Shell by typing r (Help) . 

When you type b, menus in the system are listed: 



Backup FloppyBackup Start? 

Backup? FloppyBackup? SysAdmin 

Commands? Help SysAdmin? 

Dir Help? TapeBackup 

Dir? Mail TapeBackup? 

Execute Mail? 

Execute? Start 
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SYSTEH 

ADMINISTRATION 
RESPONSIBILITIES 



The system administrator needs to periodically check 
and maintain the XENIX operating system to keep it 
running smoothly. 

Responsibilities of the system administrator are 
o Installing the XENIX operating system 
o Setting up (configuring ports) 
o Adding or changing user accounts 
o Checking and cleaning up files 



o Backing up the file system 

o Managing disk space 

o Shutting down the system 

o Troubleshooting the system. 



THE SUPER 
USER 



Becoming 
Super User 



You perform system administration functions as the 
"super user," During the installation of XENIX, the 
system automatically makes you the super user. 

When you perform other system-administration tasks, you 
may also need to become the super user. If you are not 
the super user, and you try to do one of these tasks, 
the Business Shell will display a message telling you 
to become the super user. 

You can become super user by logging in as "admin" or 
"root," or entering "su" after you have logged in as a 
regular user. 

Because the super user performs critical functions such 
as managing disk space and shutting down the system, 
you should assign a password to admin and root. Before 
setting a password, be sure you understand how to set 
them. Forgetting a password has annoying consequences. 
For more information on setting passwords, refer to 
Chapter 2. 

To become super user in the Business Shell, 



1, Log in as admin <CR>. The Business Shell main 
menu appears on the screen. 

2, Type k. System Administration, under the System 
and Help section. 

3, Type n. Become Super User. The message "Becoming 
Super User ...." is displayed on the screen, and 
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if a password has been established, you are 
prompted for it, 

4. Enter admin's password. The Business Shell main 
menu appears on the screen. 

To become super user in the XENIX Shell, 

1, Log in as root <CR>, You are prompted for the 
super-user password if one has been established, 

2, Enter root's password. The super-user prompt (#) 
is displayed. 

To become su, 

1, If you are in the Business Shell, enter Jsu <CR>. 

2, If you are in the XENIX shell (as a regular user 
with the § prompt), enter su <CR>. 

3, When you are prompted for the password, enter 
root's password. 

When you finish the super-user function(s), you can 
return to your user account by pressing q (Business 
Shell), or <CTRL-D> (XENIX Shell). 

For system security, you will want to set passwords for 
the super-user login accounts, root and admin. 

To set a password for root and admin, first log in as 
that user. Then follow the instructions in Setting and 
Changing Passwords, Chapter 2. 

Once you bring the system up for multiple users, the 
screen displays 

Altosnnn login: 

The system expects you to log in as an individual user 
or as the system administrator (super user). 

When you first start up, the system has login names to 
help you get started. However, you should create indi- 
vidual login user accounts for each user. 

When you log in to the XENIX operating system, it may 
display either 

o The Business Shell menu (Figure 3-2) 

o The XENIX Shell (you see a prompt: either # or 
$), The prompt means the system is ready to ac- 
cept your entry from the keyboard. A # is the 



super-user prompt. A dollar sign ($) prompt is 
for regular users. 

Exercise caution when working as the super user. You 
have more privileges than the regular user, but this 
means that you can have more of an effect (positive or 
adverse) on system performance. 

When you see the "login;" message, you can reply with 
one of the following login names: 

admin — Logs you into the Business Shell menu as 

a super user. 

user — Logs you into the Business Shell menu as 

a regular user. 

root — Logs you into the XENIX Shell as a super 

user (# prompt). 

Unix — Logs you into the XENIX Shell as a regu- 

lar user ($ prompt). 

user ncunes — Logs a user on the system as a regular 

user in the shell his user account speci- 
fies. 
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SYSTEM 

ADMINISTRATION 
MENU 



USER 

ADMINISTRATION 



The rest of this chapter tel 1 s you how to check and 
maintain the system, e.g., back up and restore files, 
add a new user, and change file ownership. 

To access the system administration utilities from the 
Business Shell main menu, type k. System Adminis- 
tration. The System Administration menu appears 
(see Figure 4-1) . 



[SysAdmin] 
User; admin 

System Management 



SYSTEM ADMINISTRATION UTILITIES 



Directories & Fileg 



a. User Administration e. Change Directory 

Backup/Restore Files f. List Directory (long) 

c. Port Configuration g. Change File Permissions 

d. Check and Clean up Files h. Change File Ownership 

i. Change File Group 
Utilities j. File space 

k. Time and Date 

1. Who is on the System? 

m. Display Processes 

n. Kill Processes 

o. Become Super User 

p. Go to System Maintenance mode 

s. Shut Down the Systea 



What system administration function do you desire?> 



Figure 4-1. The System Administration Menu 

To add users to the system or change user characteris- 
tics, 

1. Type bsh to access the Business Shell. 

2. Type k to access the System Administration menu. 

3. Type a to access the User Administration program. 

The user Administration screen appears (see Figure 
4-2) . 
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SYSTEM The system administrator needs to periodically check 

ADMINISTRATION and maintain the XENIX operating system to keep it 
RESPONSIBILITIES running smoothly. 

Responsibilities of the system administrator are 



o Installing the XENIX operating system 

o Setting up (configuring ports) 

o Adding or changing user accounts 

o Checking and cleaning up files 

o Backing up the file system 

o Managing disk space 

o Shutting down the system 

o Troubleshooting the system. 



THE SUPER 
USER 



Becoaing 
Saper User 



You perform system administration functions as the 
"super user." During the installation of XENIX, the 
system automatically makes you the super user. 

When you perform other system-administration tasks, you 
may also need to become the super user. If you are not 
the super user, and you try to do one of these tasks, 
the Business Shell will display a message telling you 
to become the super user. 

You can become super user by logging in as "admin" or 
"root," or entering "su" after you have logged in as a 
regular user. 

Because the super user performs critical functions such 
as managing disk space and shutting down the system, 
you should assign a password to admin and root. Before 
setting a password, be sure you understand how to set 
them. Forgetting a password has annoying consequences. 
For more information on setting passwords, refer to 
Chapter 2. 

To become super user in the Business Shell, 



1. Log in as admin <CR>. The Business Shell main 
menu appears on the screen. 

2. Type k, System Administration, under the System 
and Help section. 

3. Type n. Become Super User. The message "Becoming 
Super User ...." is displayed on the screen, and 
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Setting Super 
User Passwords 



Getting 
Started in 
the XENIX 
System 



if a password has been established, you are 
prompted for it. 

4. Enter admin's password. The Business Shell main 
menu appears on the screen. 

To become super user in the XENIX Shell, 

1. Log in as root <CR>, You are prompted for the 
super-user password if one has been established. 

2. Enter root's password. The super-user prompt (#) 
is displayed. 

To become su, 

1. If you are in the Business Shell, enter Isu <CR>. 

2. If you are in the XENIX shell (as a regular user 
with the $ prompt), enter su <CR>. 

3. When you are prompted for the password, enter 
root's password. 

When you finish the super-user function(s), you can 
return to your user account by pressing q (Business 
Shell), or <CTRL-D> (XENIX Shell). 

For system security, you will want to set passwords for 
the super-user login accounts, root and admin. 

To set a password for root and admin, first log in as 
that user. Then follow the instructions in Setting and 
Changing Passwords, Chapter 2. 

Once you bring the system up for multiple users, the 
screen displays 

Altos5 86 login: 

The system expects you to log in as an individual user 
or as the system administrator (super user). 

When you first start up, the system has login names to 
help you get started. However, you should create indi- 
vidual login user accounts for each user. 

When you log in to the XENIX operating system, it may 
display either 

o The Business Shell menu (Figure 3-2) 

o The XENIX Shell (you see a prompt: either # or 
$). The prompt means the system is ready to ac- 
cept your entry from the keyboard. A # is the 
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super-user prompt. A dollar sign ($) prompt is 
for regular users. 

Exercise caution when working as the super user. You 
have more privileges than the regular user, but this 
means that you can have more of an effect (positive or 
adverse) on system performance. 

When you see the "login;" message, you can reply with 
one of the following login names: 

admin — Logs you into the Business Shell menu as 

a super user. 

user — Logs you into the Business Shell menu as 

a regular user. 

root — Logs you into the XENIX Shell as a super 

user (# prompt). 

Unix — Logs you into the XENIX Shell as a regu- 

lar user ($ prompt). 

user names — Logs a user on the system as a regular 

user in the shell his user account speci- 
fies. 
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SYSTEM 

ADMINISTRATION 
UTILITIES 



USER 

ADMINISTRATION 



This section tells you how to check and maintain the 
system, e.g., back up and restore files, change file 
ownership, and display a process. 

To access the system administration utilities from the 
Business Shell, type k. System Administration. The 
System Administration menu appears (see Figure 4-1). 



[SysAdmin] 
User: admin 



System Management-. 



SYSTEM ADMINISTRATION UTILITIES 



Directories & Files 



User Administration e. Change Directory 

Backup/Restore Files f. List Directory (long) 

Port Configuration g. Change File Permissions 

Check duu Clean up Files h. Change File Ownership 

i. Change File Group 

Utilities j. File space 



k. Time and Date 

1. Who is on the System? 

m. Display Processes 

n. Kill Processes 

o. Become Super User 

p. Go to System Maintenance mode 

s. Shut Dovn the Systea 



What system administration function do you desire?> 



Figure 4-1. The System Administration Menu 

To add users to the system or change user characteris- 
tics, 

1. Type bsh to access the Business Shell. 

2. Type k to access the System Administration menu. 

3. Type a to access the User Administration program. 

The User Administration screen appears (see Figure 
4-2) . 
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[SysAdminl 
User: admin 

SVBtgm M»na9»in>nf 



SYSTEM ADMINISTRATION UTILITIES 



Directories t Filgti 



{aj User Administration e. Change Directory 

If; Backup/Restore Piles f. List Directory (long) 

c. Port Configuration g. Change Pile Permissions 

d. Check and Clean up Piles h. Change File Ownership 

i. Change File Group 

utnitioB j. File space 

k. Time and Date 

1. Who is on the System? 

m. Display Processes 

n. Kill Processes 

o. Become Super User 

p. Go to System Maintenance mode 

s. Shut Down the Systea 



What system administration function do you de8ire?> 



User AdBlnictratlon 
Coawuidsi shovr add, d*lct*, chui<|«> uMC, Osais, group. Groups, halpl, quit 



l>- 



Figure 4-2. User Adninistration Screen 
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Dser 

Administration 
Commands 



Creating 
a User 
Account 



A line of commands displays at the top of the User 
Administration screen, A description of each command 
follows. 



Command 

add user username 
add group groupname 
delete user username 

delete group groupname 

show user username 
show group groupname 

change user username 
change group groupname 

show Users 
show Groups 

I [<shell command>] 

help 
quit 



Description 

Adds a new user to the system 
Adds a new group to the system 
Deletes an old user from the 
system 

Deletes an old group from the 
system 

Displays a user's attributes 
Displays a group's attributes 

Changes a user's attributes 
Changes a group's attributes 

Shows all current users 
Shows all current groups 

Returns to XENIX Shell; execute 
commands 

Displays the help screen 
Returns to Business Shell or 
Unix Shell 



Enter just the first letter of a command. Guidelines 
for creating/changing a user account follow. 

To add a user, 

1. Enter a ("add" appears on the command line) 

2. Enter u ("user" appears next to "add") 

3. Enter a user name, and press the Return key. 

You can only enter one user or group at a time; add 
Users and add Groups are not legal commands. 

NOTE 



If you make a mistake while typing, the Es- 
cape key backspaces over an entire user name 
or group name. <Control-x> cancels the cur- 
rent operation. RUBOUT or DEL returns you to 
the command level. 

The system automatically assigns user ID, group ID, 
full name, directory, and shell. Initially the pass- 
word is unset. The new user can set his own password. 
If your system is on a network, make sure the user ID 
and account name are the same on all machines in the 
network. 
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For example, to add a user named rich, enter the fol- 
lowing: 



|V — . — 

/ add user rich <CR> 
The system responds with: 



Updating new user: rich 



The screen then displays the system settings for rich 
(see Figure 4-3); you can then select a setting to 
change by typing the single letter that is to the left 
of each line. 



In the future, if you want to unset a password, enter e 
<CR>. The password line displays <NOT SET>. Change 
the login shell if desired (the default is the Business 
Shell — /bin/bsh). 

IV— — Yl 



Osec AdBinistcation 

Coaunds: show, add, delete, change, user. Usees, group. Groups, helpl, qnit 



a. Oser: rich 

b. User ID: 28 

c. Group: other 

d. Group Id: 1 

e. Password: <NOT SBT> 
£. Pull Naae: rich 

g. Directory: /usr/rich 

h. Shell: /bin/bsh 

q. (quit — return to top level) 



Conand: add user rich <CIt> 



-A 



Figure 4-3. Example of Creating a New Oser Account 



Then enter q to cause the changes to take effect. 
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The system displays: 



Guidelines 



Installing files from /etc/newuser 
Command : 

You can now enter another User Administration command, 
or type q to return to the System Administration menu. 

NOTE 

If you access the User Administration screen 
from the system installation procedure, q 
will resume installation. 

When you create or change a login user account, use the 
following guidelines: 

1. Make the user name short (the user will enter it 
often). A user name can have up to 14 letters or 
numbers, but it cannot contain a space. 

The user enters the name exactly as created, in- 
cluding upper-case and lower-case letters. For 
this reason, many people use only lower-case 
names, such as "mcgregor" instead of "McGregor." 

2. Do not use a name with only upper-case letters 
unless that person actually has a terminal with 
only upper-case letters. If a name is created 
with only upper-case letters, XENIX assumes that 
the user has a terminal with only upper-case let- 
ters, such as a Teletype. Strange things happen, 
and the use of the system is hampered. 

3. Always make sure that the password is not set. If 
one is set, no one will be able to log in to that 
account. 

4. To remove a password that someone has forgotten, 
change the password to not set by entering <CR> 
for the password field. 

5. Choose the shell the user will log in to. By 
default, new users log in to the Business Shell 
(/bin/bsh). Only the Business Shell has menus. 



The shells are 



o /bin/bsh — Business Shell (with menus) 
o /bin/sh — XENIX Shell 

o /bin/csh — C Shell (only available with the 
XENIX Development System.) 



4-10 



For your system to work properly with a printer or 
terminal, XENIX needs to know certain things about that 
printer or terminal. Your system is already set up to 
let you connect Altos II terminals and standard print- 
ers to the ports on the back of the computer. Tables 
1-1 and 1-2 show the factory (default) settings for the 
ports. 

If you want to connect another type of printer or 
terminal, use the Port Configuration program. You must 
be super user to use this program. 

You can't change a port while it is being used. Ask 
the user to log off before you change the port. 

To access the port configuration program, 

1. Type k to select the System Administration menu. 

2, Type c to select the Port Configuration program. 
The screen displays current terminal assignments 
for the ports on your system. 

NOTE 

To stop the screen from scrolling (the text 
rolling up on the screen), press <Control-s>, 
To continue scrolling, press <Control-q>. 



[SysAdmin] 
User : admin 



SYSTEM ADMINISTRATION UTILITIES 



User Administration 
Backup/Restore Files 
Port Configuration 
Check and Clean up Files 

Utilities 



Directories & Files 

e. Change Directory 

f. List Directory (long) 

g. Change File Permissions 

h. Change File Ownership 

i. Change File Group 
j. File space 



Time and Date 

Who is on the System? 

Display Processes 

Kill Processes 

Become Super User 

Go to System Maintenance mode 

Shut Doira the Systea 



What system administration function do you desire?> 



Bacdwace Software Device Terminal Printer Baud Parity word Moden? 
Naae Naae Type Type Huaber Sate Len 



Port 1 
Port 2 
Port 3 
Port 4 
Port 5 



console 
tty2 
tty3 
tty4 
ttyS 



terminal 
terminal 
terminal 
terminal 
printer 



altos2 
altos2 
altos2 
alt082 



96 S« 
9601 
9611 
96M 

default 96B( none 



(cjbange port, 
(r)emove port. 



(d)iBplay, (h)elp, 
(t)est printer 



^pe a command (c, d, b, q, r. 



(g)uit, 
t) and press RETDBH: 



Port configuration commands are 

c = Change a port assignment 

d = Display all port assignments 

h = Display the port configuration help message 

q = Exit from the port configuration program 

r = Remove a port assignment 

t = Test a printer 

To select a command, type the command letter and press 
the Return key. 
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To change a port's configuration, 

1. Type c <CR> to change a port assignment. The 
screen displays 

Change which port? Type a port name: 

2. Type the port hardware or software name, for exam- 
ple, type console <CR> for the terminal connected 
to port 1, port 2 for port 2, and so on. 

The screen displays the current settings for that 
port. The system then asks you questions about 
the device that is attached to that port. 

3. The screen displays the type of device connected 
to that port; valid types are terminal, printer, 
or none (no device connected to that port). Spec- 
ify a new type of device, or press the Return key 
to leave this setting unchanged. 

4. For terminals, the screen displays the terminal 
type, for example altos2 for the Altos II terminal. 

Type a ? <CR> to scroll through the screens of 
terminal names. Press any key plus <CR> to return 
to the name selection screen. 

Type the name that corresponds to your device, or 
press the Return key to leave this setting un- 
changed, 

5. Then the screen displays the current speed (baud 
rate) for that port. Possible speeds are 110, 
150, 300, 1200, 2400, 4800, 9600, or 19200. 

Specify a new speed, or press the Return key to 
leave this setting unchanged, 

6. Next, a message tellsyou that there is no auxil- 
iary (transparent) printer on that port. That is, 
there is no printer connected to the terminal that 
is connected to that port. 

If you want to connect an auxiliary printer, type 
y <CR>; otherwise, press the Return key to leave 
this setting unchanged. 

7. Finally, a message tells you there is no modem on 
that port. Type y <CR> if you wish to connect a 
modem, or press the Return key to leave this 
setting unchanged. 

The final settings are displayed for that port. Then 
the command line reappears on the screen. 



If you want to exit from the program, type q <CR>, 

The system asks for confirmation that the port assign- 
ments are correct. If they are correct, type y <CR>, 
The system updates the port configuration information. 

Your system is already set up for a printer (see 
Table I-l or 1-2). If you wish to change the printer 
port, or add a printer, 

1. Specify "printer" in Step 3, Changing a Port. 

2. Next, a message asks you to specify a printer 
number for the port. Valid numbers are 0 through 
9. The default printer is printer 0, For exam- 
ple, the first (default) printer number is 0, the 
second printer connected is 1, and so on. 

3. The screen displays the current speed (baud rate) 
for that port. Possible speeds are 110, 150, 300, 
1200, 2400, 4800, 9600, or 19200. Specify a new 
speed, or press the Return key to leave this 
setting unchanged. 

4. Next, the screen displays the current parity set- 
ting, either odd, even, or none. Specify a new 
parity, or press the Return key to leave this 
setting unchanged. 

5. If you change the parity setting, the word length 
(in bits) is automatically adjusted for you. For 
no parity, the word length is 8, for odd or even 
parity, the word length is 7. 

6 . Final ly, a message tel 1 s you there is no modem on 
that port. Type y <CR> if you wish to connect a 
modem, or press the Return key to leave this 
setting unchanged. 

The screen displays the final settings for that port. 
Then the command line reappears on the screen. At this 
point, you should test the printer port. 

After you set up a port for a printer, test it by 
selecting t <CR>, Test a printer. 

1. Type a printer number or port name. For example, 
if you just set up port 4 for printer 1 (the 
second printer on your system), you can type 
either tty4 or 1. 

2. A message tells you the system is testing the 
printer you specified, and the screen displays the 
settings for that port. 



CONFIGURING 
THE PORTS 



For your system to work properly with a printer or 
terminal, XENIX needs to know certain things about that 
printer or terminal. Your system is already set up to 
let you connect Altos II terminals and standard print- 
ers to the portson the back of the computer. Table 1-1 
shows the factory (default) settings for the ports. 

If you want to connect another type of printer or 
terminal, use the Port Configuration program. You must 
be super user to use this program. 

You can't change a port while it is being used. Ask 
the user to log off before you change the port. 

To access the port configuration program, 

1. Type k to select the System Administration menu. 



2, Type c to select the Port Configuration program. 
The screen displays current terminal assignments 
for the 6 ports on the 586 or 10 ports on the 986 
system. 



NOTE 



To Stop the screen from scrolling (the text 
rolling up on the screen), press <Control-s>. 
To continue scrolling, press <Control-q>. 
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[SysAdmin] 
User: admin 

Syatem Managemenh 



User Administration 
Backup/Restore Files 
Port Configuration 
Check and Clean up Files 

utnitips 



=?1 



SYSTEM ADMINISTRATION UTILITIES 



Directories & Filpg 

e. Change Directory 

f. List Directory (long) 

g. Change File Permissions 

h. Change File Ownership 

i. Change File Group 
j. File space 



Time and Date 

Who is on the System? 

Display Processes 

Kill Processes 

Become Super User 

Go to System Maintenance mode 

Shat Oom the Systm 



What system administration function do you desire?> 



FOKT 1 coaaol* taninal 

ion 2 tty2 tciBinal 

VOKI 3 tty3 tsnanal 

FORT 4 tty4 terminal 

P0B9F 5 ttyS tarainal 

tout 6 ttyC printer 



altos2 
altos2 
altoa2 
altos2 
altoa2 



•CM 
»<■■ 

9fn 

96»t 
»<•■ 

96M 



(c)haa9« port, 
(r)anT* port, 

Typ* a rnMiiiil (c, d, b, q. 



(d)iaplay, (h)«lp, 
(t)aat printer 



t) and press unHMi 



none 8 bits 



(q)ait. 



Port configuration commands are 

c = Change a port assignment 

d = Display all port assignments 

h = Display the port configuration help message 

q = Exit from the port configuration program 

r = Remove a port assignment 

t = Test a printer 



To select a command, type the command letter and press 
the Return key. 
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Changing 
a Port 



To change a port's configuration 

1. Type c <CR> to change a port assignment. The 
screen displays 

Change which port? Type a port names 

2. Type the port hardware or software name, for exam- 
ple, type console <CR> for the terminal connected 
to port 1, port 2 for port 2, and so on. 

The screen displays the current settings for that 
port. The system then asks you questions about 
the device that is attached to that port, 

3. The screen displays the type of device connected 
to that port; valid types are terminal, printer, 
or none, which means there is no device connected 
to that port. Specify a new type of device, or 
press the Return key to leave this setting un- 
changed. 

4. For terminals, the screen displays the terminal 
type, for example altos2 for the Altos II termi- 
nal. 

Type a ? <CR> to scroll through the screens of 
terminal names. Press any key plus <CR> to return 
to the name selection screen. 

Type the name that corresponds to your device, or 
press the Return key to leave this setting un- 
changed. 

5. Then the screen displays the current speed (baud 
rate) for that port. Possible speeds are 110, 
150, 300, 1200, 2400, 4800, 9600, or 19200. 

Specify a new speed, or press the Return key to 
leave this setting unchanged. 

6. Next, a message tells you that there is no auxil- 
iary (transparent) printer on that port. That is, 
there is no printer connected to the terminal that 
is connected to that port. 

If you want to connect an auxiliary printer, type 
y <CR>; otherwise, press the Return key to leave 
this setting unchanged, 

7. Finally, a message tells you there is no modem on 
that port. Type y <CR> if you wish to connect a 
modem, or press the Return key to leave this 
setting unchanged. 
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Setting Dp 
a Printer 



The final settings are displayed for that port. Then 
the command line reappears on the screen. If you want 
to exit from the program, type q <CR>. 

The system asks for confirmation that the port assign- 
ments are correct. If they are correct, type y <CR>. 
The system updates the port configuration information. 

Port 6 is already set up for a printer. If you wish to 
specify another port, or add additional printers, 

1. Specify "printer" in Step 3, Changing a Port, 

2. Next, a message asks you to specify a printer 
number for the port. Valid numbers are 0 through 
9. The default printer is printer 0, For exam- 
ple, the first (default) printer number is 0, the 
second printer connected is 1, and so on. 

3. The screen displays the current speed (baud rate) 
for that port. Possible speeds are 110, 150, 300, 
1200, 2400, 4800, 9600, or 19200. Specify a new 
speed, or press the Return key to leave this 
setting unchanged. 

4. Next, the screen displays the current parity set- 
ting, either odd, even, or none. Specify a new 
parity, or press the Return key to leave this 
setting unchanged. 

5. If you change the parity setting, the word length 
(in bits) is automatically adjusted for you. For 
no parity, the word length is 8, for odd or even 
parity, the word length is 7. 



Testing a 
Printer 



6. Finally, a message tells you there is no modem on 
that port. Type y <CR> if you wish to connect a 
modem, or press the Return key to leave this 
setting unchanged. 

The screen displays the final settings for that port. 
Then the command line reappears on the screen. At this 
point, you should test the printer port. 

After you set up a port for a printer, test it by 
selecting t <CR>, Test a printer. 

1. Type a printer number or port name. For example, 
if you just set up port 7 for printer 1 (the 
second printer on your system), you can type 
either port 7 or 1. 

2. A message tells you the system is testing the 

printer you specified, and the screen displays the 
settings for that port. 
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Then the following display appears on the screen: 



ABCDEPGHIJKLMNOPQRSTUVWXYZ 
abcdef ghij klmnopqrstuvwxyz 
0123456789 1 §#$%"&*() [1 {} ; ' i ./<>? 



This display should also print at the printer, and the 
printer should advance to the top of the next page. 

If the display prints correctly, the printer is set up 
correctly. 

However, if it does not print correctly, check one or 
more of the following: 

o The baud rate on the printer, 
o The parity setting on the printer, 
o The printer setting for linefeed or carriage 
return. 

o The printer setting for X-ON/X-OFF protocol, 
o The word length setting. 

If you wish to remove a port assignment, display the 
command menu of the Port Configuration program. Make 
sure no one is using that port. 

1. Type r <CR>, Remove a Port Assignment. 

2. The screen asks you to type the port name. Type 
either the hardware or software name. That port 
is removed from use. 

When you finish configuring the ports, type q <CR> to 
quit. The screen displays 



: . 

/ Are you certain the port assignments are now 
/ correct? (y/n) 



Type y <CR> to confirm. The screen displays 



PORT CONFIGURATION CONCLUDED 




BACKING 
UP AHD 
RESTORING 
FILES 



You should regularly back up the file system on your 
hard disk by making copies of those files on floppy 
diskettes or magnetic tape. You should make several 
copies of sensitive or potentially expensive data or 
programs. If a file system crash occurs, or if your 
tape or floppy diskette becomes damaged, you will then 
have a backup copy. 

You can back up and restore single files and whole 
directories or subdirectories. 



1. Type k to access the System Administration menu. 

2. Type b to access the Backup/Restore Files menu. 

3. The Backup/Restore Files menu appears. Make a 
selection. 



[Backop] 

Tha Jan 7 19s 25 1984 



wendy 



EtACXDP AHD RKSTORE 
/nsr/wendy 



a. rioppy diskette backop/ restore 

b. Magnetic tape backup/restore 



Nbat backnii/restore service do yon desire? 



Floppy 

Diskette 

Backup/Restore 

Formatting 
Diskettes 



You can back up and restore directories and files via 
floppy diskette. 



To save a file or a group of files, you need a suffi- 
cient number of floppy diskettes that have been format- 
ted for double-density operation. 

To estimate the number of diskettes you will need, 
figure that each diskette can hold approximately 250 
printed pages. Files are saved across diskette bounda- 
ries, so you can use all diskette space. Be sure to 
format enough floppy diskettes before you begin the 
backup process. 
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Backing Up 
Files 



To format a floppy disk, 

1. Type k. System Administration. 

2. Type b, Backup/Restore Files. 

3. Type a. Floppy Diskette Backup/Restore. 

4. Type e. Format a floppy disk. 
You are prompted to choose a number: 

1 - Format Floppy Diskette 

2 - Quit 

To back up a file on floppy diskette, 

Select k. System Administration 
b, Backup/Restore Files 
a. Floppy Diskette Backup/Restore 



V 



[Backup] 



Pci Jul 1 04:42 1983 



FLOPPY BACKUP hSD RESTORE 



Backup £ile(s) and/or dicectocy(s) 
Restore file(s) 
Restore the entire diskette 
Display floppy diskette directory 
PoEBat a floppy diskette 

Nhat floppy backup/restore service do you desire? 



The form of file and directory names you use is impor- 
tant. If you specify a file or directory with a com- 
plete path name, such as 

/usr/john/teapest.c <CR> 

The backup procedure makes note that a complete path- 
name was used. When the file is restored, it's put 
back as /usr/j ohn/ tempest. c, regardless of the working 
directory of the restorer. The restore overwrites any 
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Restoring 
Files 



previous file of that name, and, if necessary, creates 
a directory in which to put it. A complete pathname is 
one that begins with "/•" 

The system asks you to remove and insert diskettes 
whenever files or directories are too big for a single 
diskette. Label and number the diskettes, (Be sure to 
indicate the total number, such as 1 of 5, 2 of 5, 
etc.) The sequence of diskettes is important because 
files are being saved across diskette boundaries. The 
first part of a file may be on one diskette, the rest 
on the next diskette. Restore files in the order they 
were backed up. When you are finished, store the 
diskettes in a safe place. 

To restore a directory with all its subdirectories and 
files, proceed as follows, 

1, Insert the first floppy disk in the sequence, 

2, Change to the name of the directory to be re- 
stored. 



3. Type b. Restore file(s) or c. Restore the entire 
diskette. 



Listing 
Saved Files 

Magnetic 
Tape Back- 
Up/Restore 



Backing Up the 
Hard Disk 



For example, to restore all the files in the directory 
named /usr/wendy (the only contents of one diskette), 
load the diskette, and type c, Restore the entire 
diskette. 

It is not necessary for the restore designation to 
match the designation used to save the files. In the 
example above, the /usr/wendy files can be restored 
from files saved under /usr. 

To list the files on a floppy disk, type e. Display 
floppy diskette directory. 

You can back up and restore from the hard disk to 
magnetic tape. 



NOTE 

The 4 86 system does not have this option. 
To back up the entire hard disk to tape, 

1, Type k. System Administration. 

2, Type b, Backup/Restore Files, 

3, Type b. Magnetic Tape Backup/Restore, 
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Backing Up 
Files 



To format a floppy disk, 

1. Type k, System Administration. 

2. Type b, Backup/Restore Files. 

3. Type a, Floppy Diskette Backup/Restore, 

4. Type e, Format a floppy disk. 
You are prompted to choose a number: 

1 - Format Floppy Diskette 

2 - Quit 

To back up a file on floppy diskette, 

Select k, System Administration 
b, Backup/Restore Files 
a. Floppy Diskette Backup/Restore 



[Backup] 



Pel Jul 1 04:42 1983 



FLOPPY BACKOP AND RESTORE 



Backup £ile(s) and/or directocy(s) 
Restoce file(s) 
Restoce the entice diskette 
Display floppy diskette directory 
Format a floppy diskette 

What floppy backup/cestoce service do you desire? 



The form of file and directory names you use is impor- 
tant. If you specify a file or directory with a com- 
plete path name, such as 

/usr/john/tempest.c <CR> 

The backup procedure makes note that a complete path- 
name was used. When the file is restored, it's put 
back as /usr/john/tempest.c, regardless of the working 
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Restoring 
Files 



Listing 
Saved Piles 

Magnetic 
Tape Back- 
Up/Restore 

Backing Up the 
Hard Disk 



directory of the restorer. The restore overwrites any 
previous file of that name, and, if necessary, creates 
a directory in which to put it. A complete pathname is 
one that begins with "/." 

The system asks you to remove and insert diskettes 
whenever files or directories are too big for a single 
diskette. Label and number the diskettes. (Be sure to 
indicate the total number, such as 1 of 5, 2 of 5, 
etc.) The sequence of diskettes is important because 
files are being saved across diskette boundaries. The 
first part of a file may be on one diskette, the rest 
on the next diskette. Restore files in the order they 
were backed up. When you are finished, store the 
diskettes in a safe place. 

To restore a directory with all its subdirectories and 
files, proceed as follows. 

1. Insert the first floppy disk in the sequence. 

2. Change to the name of the directory to be re- 
stored. 

3. Type b. Restore file(s) or c. Restore the entire 
diskette. 

For example, to restore all the files in the directory 
named /usr/wendy (the only contents of one diskette) , 
load the diskette, and type c. Restore the entire 
diskette. 

It is not necessary for the restore designation to 
match the designation used to save the files. In the 
example above, the /usr/wendy files can be restored 
from files saved under /usr. 

To list the files on a floppy disk, type e. Display 
floppy diskette directory. 

You can back up and restore from the hard disk to 
magnetic tape. 



To back up the entire hard disk to tape, 

1. Type k. System Administration. 

2. Type b, Backup/Restore Files. 

3. Type b. Magnetic Tape Backup/Restore. 
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[TapcBackup] 



TAPK BACKDP ABD SBSTOBB 



Tn« Jon 26 18:48 1984 



wendy 



a. Bacluip the entire bard disk to tape 



b. Restore individual £ile(s) froa tape 



c. Display tape directory 



What tape backup/restore service do you desire? 




The Tape Backup/Restore menu asks you to select one of 
the following: 

a. Backup the entire hard disk to tape 

b. Restore individual file(s) from tape 

c. Display tape directory 

When backing up to tape, the menu system copies the 
entire file system on the hard disk on to tape. 

When restoring from tape, the menu system can only 
restore individual files from the tape to the hard 
disk. It is not possible to restore the entire tape to 
the hard disk using the menu system. 

If you want to restore every file from the tape to the 
hard disk, use the restore option on the Welcome to 
XENIX menu. You must shut down and reboot the system 
from a copy of the diskette labeled "XENIX Root File 
System" to display this menu. However, be aware that 
you will overwrite all existing data on the hard disk 
and restore the hard disk to the condition at the time 
of the dump. 

Additional information about using tape backup is 
available in the help menus. 



1. Shut down and reboot XENIX from the "XENIX Root 
File System" diskette (follow the procedures de- 
scribed in Installation, Chapter 1). 



Restoring the 
Hard Disk 



To restore the contents of your hard disk from a tape 
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Backing Up/ 
Restoring the 
Second Hard 
Disk 



2. From the Welcome to XENIX menu, enter c <CR>, 
Restore data to the hard disk from cartridge tape, 

3. Insert the tape and follow instructions on the 
screen. 

CADTION 

The restore utility will overwrite all exist- 
ing data on the hard disk and restore the 
hard disk to the condition at the time of the 
backup was made. 

To back up all files on the second hard disk, 

1. Insert the tape. 

2. Enter b <CR>, Magnetic Tape Backup/Restore. Then 
enter 

I /etc/uBOunt /dev/hdla <CR> 

I dump Buf /dev/rct /dev/hdla <CR> 

To restore files from magnetic tape to the second hard 
disk, 

1. Insert the tape. 

2. Enter b <CR>, Magnetic Tape Backup/Restore. Then 
enter 

I /etc/uBOunt /dev/hdla <CR> 

I restor rf /dev/rct /dev/hdla <CR> 



CHECKING AND 
CLEANING UP 
FILES 



The file system check program examines and cleans up 
the file system. You should run this program at least 
once a day; all users should be logged off. It should 
be run more often if problems become evident, such as 
the system not recognizing valid commands. 

To verify and repair any inconsistencies in the 
/dev/root file system, 

1, Log in as admin and enter admin's password. The 
Business Shell main menu appears on the screen, 

2, Type k to select the System Administration, 

3, Type d. Check and Clean Up Files, If the file 
system is in good order, the screen displays the 
following : 
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/dev/root 

** Phase 1 - Check Blocks and Sizes 

** Phase 2 - Check Pathnames 

** Phase 3 - Check Connectivity 

** Phase 4 - Check Reference Counts 

** Phase 5 - Check Free List 

2131 files 23863 blocks 7078 free 



The following example shows file system inconsistencies 
noted by this file system check program. 



** Phase 1 - Check Blocks and Sizes 

** Phase 2 - Check Pathnames 

** Phase 3 - Check Connectivity 

** Phase 4 - Check Reference Counts 

UNREF FILE I = 2124 OWNER=RICH MODE=100644 

SIZE=30574 MTIME=Apr 27 07:56 1983 

CLEAR? y 

** Phase 5 - Check Free List 
63 BLK(S) MISSING 
BAD FREE LIST 
SALVAGE? y 



The system automatically clears and salvages the file 
system, and the following message appears: 

The system is shutting down. 



Press the RESET button to restart the system. See 
Booting From Hard Disk later in this chapter for in- 
structions. 
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OTHER 
UTILITIES 



Listing 
Directory 
(Long Form) 



The utilities discussed in this section are listed in 
the Utilities and Directory Files menus in the System 
Administration menu. The Change Directory utility is 
discussed in Chapter 3. Become Super User is described 
at the begining of this chapter. 

Listing your current directory in the long format dis- 
plays access permissions, the number of characters in 
the file, and the date of the last changes made to the 
file. 



To list your current directory (long form), type k, 
System Administration. Then type f. List Directory 
(long) , 



SYSTEM ADMINISTRATION UTILITIES 



Directories & FIIas 



[SysAdmin] 
User: admin 

System Management 

a. User Administration Change Directory 

b. Backup/Restore Files ^T) List Directory (long) 

c. Port Configuration Change File Permissions 

d. Check and Clean up Files h. Change File Ownership 

i. Change File Group 
util itiPB j. File space 

k. Time and Date 

1. Who is on the System? 

m. Display Processes 

n. Kill Processes 

o. Become Super User 

p. Go to System Maintenance mode 

s. Shut Dom the Systea 



What system administration function do you desire?> 



Directory: /etc 



total 152 
-cwxc-xc-x 
-rw-r — r — 
-nrx — X — z 
-rw-r — r — 

-rvx — X 

-rwx — z — z 
-rvx — z — z 



1 


root 


329 


Jan 


27 


ff 


ff 


asktine* 


1 


root 


If 


Jan 


27 


Bf 


ff 


checklist 


1 


root 


1982 


Jan 


27 


If 


ff 


qetty* 


1 


root 


44 


Jan 


27 


ff 


ff 


group 


1 


root 


3564 


Jan 


27 


ff 


ff 


haltsys* 


1 


root 


123f 


Jan 


27 


ff 


ff 


inir* 


1 


root 


4784 


Jan 


27 


ff 


ff 


init* 
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Changing File 
Permissions 



The directory name is at the top of the listing. Each 
column entry (for the first entry) has the following 
meaning: 

total = total number of 512-byte blocks 

-rwxr-xr-x = permission mode (refer to Changing 
File Permissions in this section) 

1 = number of links to the asktime file 

root = file owner 

329 = number of characters (bytes) in ask- 
time 

Jan 29 = date of last change 

00:00 = time (24-hour clock) of last change 

asktime* = file name 

Files can be shared by members of your group and other 
system users unless you restrict access to files by 
changing the permission. When a file is created, it 
can be read by all users. (Directories can be read and 
searched by all users.) 



There are three levels of permission (read, write, and 
execute) and three kinds of users (you, your group, and 
all other system users). You have read, write, and, if 
appropriate, execution permission for your files. Some 
files, such as a letter file, can't be executed. 

To check your file access permissions, type k, System 
Administration. Then type f. List Directory (long). A 
line is displayed for each file. Note the positioning 
of r, w, X, For example, 

-rwx rwx rwx 1 carol 9 Apr 27 15:13 memo 

i I I 
user group other 
(you) 



where 



- (first column) = file; d = directory 



r = read 

w = write 

X = execute 

- (after first column) 



= permission denied, 

whether read, write, or 
execute depends on place- 
ment. 
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For example, a "r-x" means that write permission is 
denied. 

To change file permission, type k, System Administra- 
tion. Then type g. Change File Permissions, The 
prompt "FileCs) for which permissions are to be chang- 
ed?" appears. Enter the file name(s) separated by a 
space and press the Return key. The screen displays 
the current permissions and prompts: "Change files to 
permission. " 

First, enter the class(es) of users for which permis- 
sion is to be changed. This is some combination of "u" 
(user), "g" (group), or "o" (other) (or all three; "a" 
(all) is the default). You can add ( + ) or remove (-) 
one of the three permissions: "r" (read), "w" (write), 
or "x" (execute). For example, if you want group 
members to execute one of your files, enter 




If you want to deny group members and all others read 
permission for a file, enter 



go-r <CR> 



Changing File To change file ownership, type k. System Administra- 

Ownership tion. Then, type h. Change File Ownership. The prompt 

"File(s) for which ownership is to be changed?" ap- 
pears. Enter the file name(s) and press the Return 
key. You are shown the current owner (s) for the 
file(s), and prompted "Change file to owner." Enter a 
valid owner name. When you list your directory, that 
directory's f ile(s) are displayed with their new owner 
name. 

Changing File To change file groups, log in as a super user. Type k. 

Groups System Administration. Then, type i. Change File 

Group. The prompt "file(s) for which the group is to 
be changed?" appears. Press <CR> if you wish to see 
the current groups for the files. After you enter the 
file name(s), the "current group(s) for these files" 
displays. Then the prompt "Change files to group:" 
appears. Enter a valid group name. 
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Displaying 
Disk Usage 
(File Space) 



We recommend you run this program at least once a day. 
If you run out of disk space, perhaps because you are 
running a lot of processes, you can lose what you are 
working on, or worse, won't be able to clean up the 
disk space. If the latter occurs, you have to reboot 
the system. 

If you are consistently reaching 500 blocks of avail- 
able space, you should consider obtaining additional 
space by deleting files no longer used. 

To display disk usage, type k, System Administration. 
Then type j. File Space. 



r 



[SysAdmin] SYSTEM ADMINISTRATION UTILITIES 

User: admin 

Syaten Manageaent pirectoriea & Piion 

a. Usei Administration e. Change Directory 

b. Backup/Restore Files £. List Directory (long) 

c. Port Configuration g. Change File Permissions 

d. Check and Clean up Files h. Change Pile Ownership 

i- Change File Group 
Ptilities Qj) File space 

k. Time and Date 
1. Who is on the System? 
m. Display Processes 
n. Kill Processes 

Become Super User 
p. Go to System Maintenance mode 
Shut Down the Systra 

What system administration function do you desice?> 



Free Blocks: 

/ (/dev/root): 34624 blocks 
Disk Osage: 

1 ./diskette 

2 ./outbox 

3 ./inbox 

30 ./XenixDevSys 
63 . 
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The screen displays 

o The remaining disk space (free blocks) 

o The directories and their block size (in 512-byte 
blocks) 

o The total number of the blocks in your current 
directory (denoted by the period). 

To determine individual file sizes, display disk usage 
via the XENIX Shell (see Appendix D). 

Displaying To display or set the date and time, type k. System 

or Setting Administration. Then type k, Time and Date, 

the Date 

and Time You can press the Return key to display the date and 

time. You can set the time and date by entering the 
year, month, day, hour, and minutes in the following 
format: 

YYMMDDHHMM 

where 

YY = current year 

MM = current month 

DD = current day of month 

HH = hour (24 hour clock) 

MM = minutes 



For example, enter December 31, 1983, 2:30 p.m. as 
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Displaying 
fVho is on 
the System 



To display who is currently logged on the system, type 
ICf System Administration. Then type 1, Who is on the 
System? 





[SysAdmin] SYSTEM ADMINISTRATION UTILITIES 
User: admin 

SvfiteaL Hanaaement Directorips a pIIab 

a. User Administration e. Change Directory 

b. Backup/Restore Files f. List Directory (long) 

c. Port Configuration g. Change File Permissions 

d. Check and Clean up Files h. Change File Ownership 

i. Change File Group 
Dtilitiea j. sp»rA 

Jc. Time and Date 

(ij) Who is on the System? 

w. Display Processes 

n. Kill Processes 

0. Become Super User 

p. Go to System Maintenance mode 

s. Shot Dawn tb« Syafeea 

\ What system administration function do you desire?> 

A- ■ -A 








Y — — 1 

Who is on the systea? 

adain console Jun 29 19:22 
Chris tty2 Jun 29 19:24 
susan tty3 Jun 29 19:57 

(Type return to continue) 1 
} ■ . — \ 



4-27 



Displaying 
Processes 



All processes on the system are assigned a process 
identification (PID) number. 



Occasionally, a program may go awry; it may loop for- 
ever or lock up your terminal. If this happens, iden- 
tify the process causing the problem. 

To display currently active processes, type k. System 
Administration. Then type m. Display Processes, to 
display information on all system processes in the long 
listing format. 



[SysAdmin] 
User: admin 



SYSTEM ADMINISTRATION UTILITIES 



System Manaqemgnt 

User Administration 
Backup/Restore Files 
Port Configuration 
Check and Clean up Piles 

Htilitiea 



Directorieg s, PilAg 

e. Change Directory 

f. List Directory (long) 

g. Change File Permissions 

h. Change File Ownership 

i. Change File Group 
j. File space 



Time and Date 

Who is on the System? 

Display Processes 

Kill Processes 

Become Super User 

Go to System Maintenance mode 

Shat Down the Systea 



What system administration function do you desire?> 



w- 

PcoMM Status 

r s oiD Pio PPID c pai hi add« si ncmui stimb 
3 S root I f 11 ■ 21 2t 4 49ef ? 
1 S root 1 t ■ M 21 123 1( Sac2 7 

• S root 34 1 • 21 2f 113 12 433C 14tl3tf 
1 S coot 31 1 f 4f 2b 3a 12 n» 15il2ta 
i S coot C3 1 1 31 2b lib 12 5..a 

• S root 78 (3 24 3f 2f 143 3< 5b3a 
1 R root 112 7* 27 S7 2b 2. 44 


— V 

TTT TiHB am 

7 2*1 1 SC nappar 

7 ■i*2 /.tc/init 

■ 2 Itfi -2 (9«tty) 

■ CO iill /.tc/updat* 

CO •if3 -ah -c /uar/llb/bah 
CO It IS /uar/lib/bin 
CO ltd pa -all 


i 


-4 
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The column 


headings 


that display are 


explained as 


follows : 








CUbUWN 
















F 


Flags 


associated with 


the process: 




01: 


in core 






0 2: 


system process 






10 4 : 


locked in core 


(physical I/O) 




11^: 


being swapped 






on. 
zt) : 


being traced by 


another process 


S 


State 


of the process 






0: 


nonexistent 














W: 


waiting 






R: 


running 






I: 


intermediate 






Z : 


terminated 






T: 


stopped 





UID 
PID 
PPID 

C 

PRI 

NI 
ADDR 

WCHAN 

STIME 
TTY 

TIME 

CMD 



The login name of the process owner. 

The process identification (PID) number. 

The identification number for the parent 
process. 

Process utilization for scheduling. 

Priority of the process; high numbers 
are low priority. 

Number used in priority computation. 

If resident in memory, the core address. 
Otherwise, the disk address. 

The event for which the process is wait- 
ing (sleeping). If blank, the process 
is running. 

The starting time of the process. 

The number of the tty (terminal or 
printer) controlling the process. 

The cumulative execution time for the 
process. 

The process. 
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Killing 
Processes 



System 

Maintenance 

Node 



You may find it necessary to stop a process because, 
for example, it locks up a terminal so you can't enter 
anything, or it is consuming too much of the system's 
resources that other tasks cannot be performed. 

To kill a process, 

1. Type k. System Administration, under the System 
and Help section of the main menu. 

2. Type m to display system processes. Note the 
process identification (PID) number for the pro- 
cesses you want to kill. 

3. Then type n. Kill Processes, The prompt "Kill 
which processes?" displays. 

4. Enter the process identification number (s) and 
press the Return key. 

After you kill a process via the Business Shell, the 
main menu returns to the screen. 

CAUTION 

Do not kill the jLnjJtf SLLSm, and the swapp er 
processes. These processes nust continue to 
run if the system is to operate properly. 

If you receive the message, "No such process," the 
process may have completed. Verify by displaying the 
process. 

You can go to System Maintenance mode when you need to 
become the only user on the system. You can, for 
example, install other software. 



To go to System Maintenance mode, type p. 
displays the following: 



The screen 
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Syata* Halntananc* soda will sbnt dont all tcrainala ezccpt th« 
■aln coaaol*. 



Do yon waat to almt down tha otbac tenlnal*? (y/n) 




Enter y <CR>. The screen will ask you to enter the 
number of minutes (0-15) until shutdown. After the 
specified number of minutes, XENIX shuts down and re- 
boots, and displays 



/ System Maintenance mode (single user) 

/* 

At this point you can work in the XENIX shell as the 
super user, or to display the Options menu you can 
enter 



options <CR> 



To bring the system back up for other users, return to 
the Options menu and enter 



a <CR> 
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SHOTTING 
DOWN THE 
SYSTEM 



If you have to turn off the power or reset your Altos 
computer system, you need to shut it down properly. 
You must be the super user to perform this function. 



To shut down the system, 

1. Log in as admin on the system console, 

2. Type k, System Administration. 

3. Type s, Shut Down the System. 
The system asks 



IV 

/ Minutes untill shutdown (0 - 15) : 

4. Enter the desired number of minutes. The system 
will send a message to all users to finish and log 
off because the system will shut down in the 
number of minutes you specify. 

5. If there is a floppy diskette in the disk drive, 
remove it. 

6. The shutdown procedure terminates with the message 

** Normal System Shutdown ** 

7. Press the power switch to OFF or press RESET. 



RECOVERING If the system is not shut down properly you may receive 

FROM IMPROPER the following message after you press the RESET button: 

SHUTDOWN 

The system was not shut down properly. 

The root file system will be cleaned. 

(Type "no" only if you want to avoid cleaning.) 



This process begins automatically after about 5 sec- 
onds. XENIX validates the consistency of the disk file 
system, which may have been damaged, and automatically 
repairs it. If there is no damage, you will see the 
following : 
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/dev/root 

** Phase 1 - Check Blocks and Sizes 



** Phase 2 
** Phase 3 
** Phase 4 
** Phase 5 



- Check Pathnames 

- Check Connectivity 

- Check Reference Counts 

- Check Free List 



nn files nnn blocks nnn free 



If the file system was damaged, XENIX repairs it auto- 
matically and displays a log of the corrections that 
were made. 



Then the system reboots automatically and asks you to 
enter the time and date. 

If you have any doubt whether the file system has been 
repaired satisfactorily, you can restore the hard disk 
from backup files. 



MOVING 

BETWEEN 

SHELLS 

Accessing the 
XENIX Shell 
from the 
Business Shell 



You can move from the Business Shell to the XENIX Shell 
and from the XENIX Shell to the Business Shell. 



You can move from the Business Shell to the XENIX Shell 
in one of two ways. From the prompt line at the bottom 
of the menu screen, enter 



I <CR> 



The XENIX prompt displays (# or $). Enter the command 
you wish to execute. 

To return to the Business Shell, press <Control-D>. 
You are then prompted to press the Return key to return 
to the menu system. 

The following example lists a working directory. 
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menu prompt > I <CR> 

$ pwd <CR> (list working directory) 
/usr/rich 

$cd schedules <CR> (change to directory named 

schedules ) 

$ls <CR> (list contents of directory) 

planning monthly old, plan 

weekly budget 
$rm old. plan <CR> (delete file) 
$<Control-D> 

$[Type RETURN to continue] <CR> 



Or, you can enter 



I coamand <CR> 



The command can be any command supported by your sys- 
tem. For example, to see how much disk space remains, 
you can either go through the sequence of Business 
Shell menus, or enter 



menu prompt > I d£ <CR> 



The system responds with the amount of disk space, for 
example /dev/rroot 11174, and the menu prompt: 



[Type RETURN to continue] 



Accessing the 
Business Shell 
from the 
XENIX Shell 



If you press the Return key, the system returns you to 
your last screen in the menu. 

In both examples, the exclamation point "connects" you 
directly to the XENIX Shell. 

To move to the Business Shell Menu from the XENIX Shell, 
after the prompt, enter: 

$ bsh <CR> 

Then the Business Shell menu appears on the screen. If 
you type q at the Business Shell prompt line, you are 
back in the XENIX Shell at the $ prompt. 
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BOOTIIIG 
PROH THE 
HARD DISK 



The following procedure explains how to start up (boot) 
your computer system from the hard disk. 

Correct an error made when entering information by 
pressing the Backspace, Rubout, or Delete key. 

1. Be sure that your terminal is connected to port 1 
at the back of the Altos computer system. 

2. Turn on the Power Switch or, with the power on, 
press the RESET button. The screen displays 




PASSED POWER-UP TEST 
Monitor Version n.nn 

Press any key to interrupt boot 



Don't press a key, the monitor will go to the hard 
disk and read in the XENIX operating system. This 
requires about 20 seconds or so. Go to step 3. 

If you happen to press a key, within a few seconds 
you will see a choice of possible entries for 
booting. Enter 1 to boot from the hard disk. 



Enter (1) to boot from Hard Disk 
Enter (2) to boot from Floppy Disk 
Enter (3) to enter from Monitor 

Enter option: 1 

The XENIX message appears. 

XENIX vn.na 
mem = nnnK 

Then the screen displays 



I think it's Day Month Date Time Year 
Enter date (yymmdd) or press RETURN 
Enter time (hhmm) or press RETURN 
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Sometimes you may get a different message. It 
starts "The system was not shut down properly..." 
If you see this message, see Recovering From Im- 
proper Shutdown in this chapter. 

5. The login prompt appears on all terminals. Re- 
spond with your user name and password, if one has 
been set. 



TRODBLESHOOTING 
THE SYSTEM 



If you perform daily preventive maintenance procedures, 
such as checking and cleaning up files, saving and 
backing up files, managing disk space on the system, 
and monitoring processes, your operating system should 
run smoothly. 

However, emergencies do occur. There may be a power 
failure; or, someone may accidently pressed the Reset 
button (causing the system to reset and shutdown im- 
properly) . 

The XENIX operating system displays error messages to 
indicate problems to the console. Additional error 
messages can also come from the individual application 
programs that you have installed. 

Some errors, such as the entering of illegal commands, 
are simple errors that an individual user can solve. 
Others, such as bad sectors on the hard disk, may 
require the running of Altos diagnostics. 

If the problem persists, and you have tried all of the 
available maintenance tools listed in this chapter, try 
checking and cleaning up files by typing d on the 
System Administration menu. If you still cannot fix the 
problem, refer to the Diagnostics manual. 
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M^, the standard XENIX text editor, is an interactive 
program for creating, viewing, and modifying files. £d 
is a line-oriented text editor. It allows you to enter 
a single command or manipulate text on a line-by-line 
basis. A line consists of a single command or text 
entered until you press the Return key. Once you are 
in the proper operating mode, you can enter text as you 
would on an electric typewriter. 

The jad editor is not a screen-oriented text editor or a 
word processor. 

A screen-oriented text editor allows you to move the 
cursor around in a file. Changes and additions that 
you make to the file are reflected on your terminal 
screen. 

A word processor is a program that includes both a 
screen-oriented editor (for typing text) and a program 
that sends codes or commands to the printer. The codes 
cause the printer to underline, etc; this program al- 
lows you to backspace, underline, justify margins, 
expand tabs, and type in boldface type. 

£d is adequate for creating simple text files (i.e., 
creating files for the electronic mail program) , or 
performing system maintenance functions (such as modi- 
fying the ttys file) . 

This chapter will give you enough information about 
the £d text editor for most of your daily needs. 



ED BASIC 
CONCEPTS 

Piles and 
Directories 



Text 



Buffer and 
Disk Space 



Command Node 
and Input Node 



Before using £d, you should be familiar with some basic 
concepts. 

A file is a collection of information, either text or 
data. Each file has a name. Files are normally 
grouped under directories. Similar files are normally 
grouped under the same directory. 

The term "text" refers to a document (such as a memo) , 
or data for a program. 

The buffer serves as a temporary work space. Text 
being worked on is kept in the buffer. You need to 
copy (write) your file from the buffer to the hard (or 
floppy) disk to save it. Otherwise, when you exit the 
editor your file will be lost. Don't worry, £d will 
tell you how to save your file. 

JId has two modes: the command mode and the input mode. 
The first mode allows you to give the editor direc- 
tions; the second mode allows you to enter and manipu- 
late text or data. 
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Error Messages 



You instruct the jed text editor what to do with your 
file by entering commands while in the command mode. 
Most commands consist of a single lower-case letter, 
such as "a* for adding text, or "m" for moving text. 
Each command is entered on a separate line. You can 
enter commands as soon as you invoke the £d editor. 

Enter the input mode from the command mode by entering 
the appropriate commands, which are described below. 
Once you are in the input mode, you can add text to the 
£d editor buffer area. 

When you are in the command mode and you make an error 
while entering commands, or when you press the Return 
key without entering a command first, the system dis- 
plays an error message. You will clLso get a zero 
response when you invoke £d with a filename that is not 
present in the current directory. If you are creating a 
new filename, ignore the zero. If you are requesting 
an existing file, be sure you are in the proper direc- 
tory and that the file you are requesting exists in 
that directory. 



IHVOKIIIG THE 
ED TEXT EDITOR 



To invoke the £ji text editor from the Business Shell, 
type f , Edit a Pile (ed) . 

The system enters the £ji text editor and prompts you 
with 




Name of file(s) to invoke editor on ? 



Enter the name of the file you want to view, create, or 
modify, and press <CR>. 

If you select an existing file, the editor responds 
with the number of bytes in that file and an aster- 
isk (*). One byte holds one character (letter, number, 
space, punctuation mark, or special symbol). The edi- 
tor is now in the command mode awaiting further in- 
structions from you. 

If you select a new file name, the editor responds 
with 



The asterisk (*) is the editor prompt, 
below, do not type in the asterisk. 



In the examples 
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The system searches for the file and responds with a 
zero indicating that the file is not present. This is 
the editor's way of letting you know it is a new file 
(that is, a file that contains zero bytes). The editor 
is now in the command mode (shown with the *) awaiting 
further instructions from you. 



CREATING A 
NEtr FILE 



You create a new file by invoking the£d text editor 
with a new file name. See Chapter 3 for file name 
limitations. 



BASIC ED 
COMMANDS 



Here are some of the basic jsd commands. 

COMMAND FUNCTION 

a Adds text to a file 

Exits from add or append (a) command mode 

p Prints or lists a file 

s Substitutes or makes changes within a line 

u Undoes the last command 

d Deletes line (s) 

m Moves lines around in a file 

r Reads or appends existing files to the 
current file 

w Writes or copies (saves) current file to 
disk 

q Quits or exits the editor 



Adding Text 
Lines To a 
File (a) 



To add text to a new or existing file, use the a com- 
mand. This command enables you to enter text on the 
"blank" lines that follow. Each time you press the 
Return key, a new line becomes available. 

When you are adding text to a newly created file, enter 
a <CR>. For example, type f on the Business Shell 
menu. The screen displays 
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Name o£ £ile(s) to invoke editor on? example <CR> 
*a <CR> 

This is the text portion of a newly <CR> 
created file, named example. Once I <CR> 
have finished adding lines of text, I <CR> 
will exit the input mode by entering a <CR> 
period followed by pressing the Return <CR> 
key. 
. <CR> 



To add text, you can enter the input mode in the fol- 
lowing ways: 



o Type a <CR> to add text after the current 

line in the file, 
o Type Na <CR> to add text after line N (a 

specific line number) in the file, 
o Type i <CR> to add text before the current 

line in the file, 
o Type Ni <CR> to add text before line N in the 

file. 



Displaying 
(Printing) 
a File (p) 



Exit the input mode by entering: 



. <CR> 



To add lines starting with line 26, enter 



*25a 



To display the file or current line on your terminal, 
use the print, p, command. You can display part or all 
of the file by entering one of the following: 

o Type lf$p, to display the entire file. 

o Type Np, to display line N. 

o Type N,Zpr to display lines N through Z. 

For example, to display the contents of the "example" 
file created above, enter. 
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Making Changes 
Within a Line 
(s) 




*l,$p <CR> 

This is the text portion of a newly 
created file, named example. Once I 
have finished adding lines of text, I 
will exit the input mode by entering a 
period followed by pressing the Return 
key. 



Note the 



and 



are not displayed. 



The example below displays lines 4 and 5 of the example 
file: 



*4,5p <CR> 

will exit the input mode by entering a 
period followed by pressing the Return 



The command 



will also display the current line. 

To make changes within a line, use the s command. This 
command is useful for correcting typos, adding or de- 
leting words, or substituting words with a line. The 
format for the sl command is: 



line#s/old text/new text/p <CR> 



where 



Line* = the line you want to change. If you do 
not enter a line number, the editor 
changes the current line, 

s = the substitute command 

old text = what you want to change 

new text = what you want to change to 

p = prints the line after the changes are 

made 

Note that a period (.) in the old text matches any 
character. 
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For example, to correct the typo (budgt) , enter 



Your budgt figures are higher than projected. 
*s/budgt/budget/p <CR> 

Your budget figures are higher than projected. 



The editor replaces the word "budgt" with the word 
"budget. " 

For example, to delete a word(s) in a line, enter 




Please submit your vacation schedules to me today. 
*8/to ae/Zp <CR> 

Please submit your vacation schedules today. 



The words "to me" are deleted from the line. 

For example, to change a word or words throughout a 
large file (a global change), use the format 



* 1 , $s/manual/dociuient/gp <CR> 

This document describes the 586 computer system. 
Refer to the reference document for more informa- 
tion. This document will be revised as needed. 



This command substitutes the word "document" for the 
word "manual" throughout the file and then prints the 
last line of the last occurrence of the word that was 
changed. The "g" that was added to the command line 
indicates that it is a global substitution. 

For example, to add text within the line by using the s. 
command, enter 

Please return the keys you borrowed. 

*s/keys/keys and book/p <CR> 

Please return the keys and book you borrowed. 



As you can see the s command is an important editing 
tool. You can reverse the last substitution you made by 
using the undo, n, command. The undo command only 
reverses the most recent substitution and only works if 
the editor is currently positioned on the affected 
line. To use the undo command, enter 
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*a <CR> 



Deleting Text 
(Lines) (d) 



Moving Text 
(Lines) Around 
In a File (m) 



Combining 
Files (r) 



To delete lines of text, use the d command. The format 
for the d command is 

(first line to delete), (last line to delete) d 

For example, if you want to delete line 4 of the file 
in the buffer, type 



To delete more than one line, for example, lines 4 
through 7 of the file, type 



*4,7d <CR> 



The delete command does not prompt you nor does it 
display the buffer. To display the file before or after 
deleting text, use the print, l,$p, command. 

To move lines of text around within the buffer, use the 
m command. For example, if you want to move lines 3 
through 5 to the end of the buffer, type 

*3,5iii$ <CR> 



The dollar sign ($) indicates the end of the file (last 
line) . 

Another example is 



*3iBl <CR> 



This example moves line 3 after line 1. 

You can combine more than one file in the £d text 
editor buffer by using the x command. This command 
allows you to "read" a file into the buffer without 
destroying anything that is already there. For example, 
you have a file named report, which contains a report 
of your expenses. You can edit a file or create a new 
file in the buffer and then combine it with an existing 
file (in this case report). Enter 
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*r report <CR> 



Saving Tour 
Text/Pile 
(Copying File 
To Disk) (w) 



This comiaand causes the ceport file to be copied into 
the buffer after the text already there. You can 
rename the combined files by using the u command to 
write to the disk as shown below: 



To save your files, use the s£ command. This command 
makes a copy of the buffer contents and puts it on a 
storage medium such as a hard disk or floppy diskette. 

To save the additions or modifications you make to your 
file, exit the input mode and type w. The system re- 
sponds with the number of bytes in the file. For exam- 
ple. 



*W <CR> 
294 



You now have a saved copy of your file with the latest 
changes. The text in the buffer remains unchanged. You 
can continue adding or modifying the buffer without 
affecting the saved file until you write to the disk 
again. 

You should save the text in the buffer before you exit 
the editor. You should also write to the disk periodi- 
cally while working on text in the editor buffer. This 
is important for the following reasons: 

o If there is a power surge, power outage, or if 

someone accidentally resets the system, your text 
in the buffer is lost. If you save your file 
periodically (i.e., once a page), at the most, you 
only have to retype one page. 

o If you are editing a large file and saving (writ- 
ing) your text in the buffer periodically, you can 
recover from an error. For example, consider the 
following possible circumstances: 



You invoke an existing file. 
You add some new text (lines) . 
You save the additional lines by writing to 
disk. 

You make some changes to some existing lines. 
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Exiting 
(Leaving) The 
Editor (q) 



You save the changes by writing to disk. 
You accidentally type in the delete command 

by mistake and press the Return key. You 
just "lost" several lines of text. 

o If you exit the editor and re-invoke it, you 
recover the deleted lines and do not lose the 
changes made prior to the mistake. If you did not 
save the previous changes, when you invoke the 
editor, you have to re-enter the changes made 
before the last write command. 

To leave the £d text editor (after saving the text), 
use command. For example. 




The system exits the editor and returns to the Business 
Shell. 

If you attempt to exit the editor without saving (writ- 
ing) your file, the system responds with a question 
mark. If you type q again, you exit the editor, and 
the text in the buffer is lost. 



EXAMPLES 



The examples in this section use the basic commands of 
the £d text editor. 



Creating a 
New Pile 



The following example creates a new file named 
"mtgnotice." You will create a file, print, edit, and 
save it on the disk. 



Type f on Business Shell main menu. The screen 
displays the following: 
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Printing 
the Pile 



Name of file(s) to invoke editor on? mtgnotice <CR> 
0 

*a <CR> 

DATE: February 14, 1983 <CR> 

TO: Department Managers <CR> 

FROM: John Wilson <CR> 

SUBJECT: Scheduling Meeting Notice <CR> 

<CR> 

<CR> 

We will meet on Tuesday, February 15, 1983, <CR> 
at 2:00 in the engineering conference room <CR> 
to go over the depatment planning schedules. <CR> 
Please bring a copy of department's schedules. <CR> 
. <CR> 
*a <CR> 

The meeting will last about 2 hours. <CR> 
Each schedule should include man-hour <CR> 
requirements, project start and completion <CR> 
dates, cuid other pertinent information. <CR> 
<CR> 

Don't be late. <CR> 
. <CR> 



To print (display) the file, enter 



*l,$p <CR> 

DATE: February 14, 1983 
TO: Department Managers 
FROM: John Wilson 

SUBJECT: Scheduling Meeting Notice 



We will meet on Tuesday, February 15, 1983, 
at 2:00 in the engineering conference room 
to go over the depatment planning schedules. 
Please bring a copy of department's schedules. 
The meeting will last about 2 hours. 
Each schedule should include man-hour 
requirements, project start and completion 
dates, and other pertinent information. 

Don't be late. 
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Editing 
the Pile 



After reading the printed version on the screen, you 
decide to improve the memo by deleting the line "Don't 
be late." Count the line number, starting with the 
first line and including blank lines. Since "Don't be 
late" is the sixteenth line, you can delete the line as 
follows: 



j *16d <CR> 



You notice that "department" is misspelled and that 
"your" is missing in the phrase "bring a copy of de- 
partment's schedules." The substitute command can fix 
these errors. 



*9s/depataent/department/p <CR> 

to go over the department planning schedules 

*lBs/of/of your/p <CR> 

Please bring a copy of your department's schedules, 



You decide that the line "The meeting will last about 2 
hours" should be the last line of the file. The text 
that follows needs to be moved above this sentence. 
Move line 12 through 14 after line 10 by entering 



*12,14iolg <CR> 



Paragraphs will make the memo easier to read. Add a 
blank line after a line by entering that line number 
and the "a" command. Press the Return key twice to 
create a blank line. Enter 



*lBa <CR> 
<CR> 
. <CR> 
*14a <CR> 
<CR> 
<CR> 
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Displaying 
the File 



Display the edited file on the screen by entering 



*lr$p <CR> 

DATE: February 14, 1983 

TO: Department Managers 

FROM: John Wilson 

SUBJECT: Scheduling Meeting Notice 



We will meet on Tuesday, February 15, 1983, 

at 2:00 in the engineering conference room 

to go over the department planning schedules. 

Please bring a copy of your department's schedules. 

Each schedule should include man-hour 
requirements, project start and completion 
dates, and other pertinent information. 

The meeting will last about 2 hours. 



When you are satisfied with the memo, save it and quit 
the editor. 
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